Linux installation

System requirements

• Linux distribution with glibc 2.31 or later (Ubuntu 20.04+, Fedora 33+, Debian 11+)
• 64-bit processor (x86_64)
• 4 GB RAM minimum (8 GB recommended)
• 500 MB available disk space
• Internet connection for license activation and AI features
• WebKit2GTK and related dependencies (see below)

Download

1. Visit the Campaign Familiar website at campaignfamiliar.com
2. Click the Download button
3. Select Linux and choose your preferred package format:
   • .deb for Debian/Ubuntu-based distributions
   • .AppImage for universal Linux compatibility

Installation steps

Option a: debian/ubuntu (.deb package)

Step 1: install dependencies

Open a terminal and install required dependencies:

sudo apt update
sudo apt install -y libwebkit2gtk-4.0-37 libgtk-3-0 libayatana-appindicator3-1

Step 2: install the package

Navigate to your Downloads folder and install:

cd ~/Downloads
sudo dpkg -i Campaign.Familiar_*_amd64.deb

If you encounter dependency errors:

sudo apt --fix-broken install

Step 3: launch Campaign Familiar

Launch from your application menu or run:

campaign-familiar

Option b: appimage (universal)

Step 1: make the appimage executable

Navigate to your Downloads folder:

cd ~/Downloads
chmod +x Campaign.Familiar_*_amd64.AppImage

Step 2: run the appimage

Double-click the AppImage file or run from terminal:

./Campaign.Familiar_*_amd64.AppImage

Optional: integrate with desktop

For application menu integration, consider using AppImageLauncher or manually create a .desktop file.

First launch

When you first launch Campaign Familiar:

1. The application will initialize its local database
2. You will be prompted to sign in or create an account
3. If you have a subscription, it will be activated automatically
4. You will see the home screen with options to create your first campaign

For details on activating your subscription, see License Activation.

Data location

Campaign Familiar stores all your campaign data locally on your computer at:

~/.local/share/campaign-familiar

To access this folder:

cd ~/.local/share/campaign-familiar

Or open in your file manager:

xdg-open ~/.local/share/campaign-familiar

This folder contains:

• Your campaign database
• Imported assets and images
• Application configuration
• Local cache files

Required dependencies

Campaign Familiar requires the following system libraries:

Installing all dependencies

Debian/Ubuntu:

sudo apt install -y libwebkit2gtk-4.0-37 libgtk-3-0 libayatana-appindicator3-1 librsvg2-common

Fedora/RHEL:

sudo dnf install -y webkit2gtk3 gtk3 libappindicator-gtk3 librsvg2

Arch Linux:

sudo pacman -S webkit2gtk gtk3 libappindicator-gtk3

Troubleshooting

Missing dependencies error

Problem: Application fails to start with errors about missing libraries.

Solution:

1. Check which library is missing from the error message

2. Install the required package using your package manager

3. For WebKit2GTK issues specifically:

   Debian/Ubuntu:

   sudo apt install libwebkit2gtk-4.0-37

   Fedora:

   sudo dnf install webkit2gtk3

Permission denied error

Problem: Cannot run the application due to permission issues.

Solution:

1. For AppImage, ensure the file is executable:

   chmod +x Campaign.Familiar_*_amd64.AppImage

2. For installed packages, check that the binary is in your PATH:

   which campaign-familiar

Application will not start

Problem: Campaign Familiar fails to launch or crashes immediately.

Solution:

1. Run from terminal to see error messages:

   campaign-familiar

   or for AppImage:

   ./Campaign.Familiar_*_amd64.AppImage

2. Check for missing dependencies in the output

3. Ensure your display server (X11 or Wayland) is running

Graphics issues on wayland

Problem: Visual glitches or rendering issues when using Wayland.

Solution:

Try running with X11 compatibility:

GDK_BACKEND=x11 campaign-familiar

Or for AppImage:

GDK_BACKEND=x11 ./Campaign.Familiar_*_amd64.AppImage

Sandbox/apparmor issues

Problem: Application blocked by AppArmor or sandbox restrictions.

Solution:

For AppImage, try with sandbox extraction disabled:

APPIMAGE_EXTRACT_AND_RUN=1 ./Campaign.Familiar_*_amd64.AppImage

Cannot find data directory

Problem: Cannot locate campaign data or configuration files.

Solution:

Campaign Familiar follows the XDG Base Directory Specification:

• Data: ~/.local/share/campaign-familiar
• Config: ~/.config/campaign-familiar
• Cache: ~/.cache/campaign-familiar

If $XDG_DATA_HOME is set, data will be at $XDG_DATA_HOME/campaign-familiar.

Next steps

After installation, continue with:

• License Activation - Activate your subscription
• Creating Your First Campaign - Get started with Campaign Familiar

Need more help? See the Installation Troubleshooting Guide for additional solutions.