linux installation

Install Code Diary on Linux

Install the .deb for a menu-integrated app on Ubuntu/Debian, or run the portable AppImage anywhere. Every step below has a copyable command, including the fixes for newer Ubuntu and FUSE.

1. 1

   Open a terminal (Ctrl + Alt + T). On Ubuntu, Debian, Linux Mint, and Pop!_OS the .deb package is recommended — it installs system-wide and adds Code Diary to your application menu automatically. Download it:

   Download the .deb

   Copy

   wget "https://github.com/Ambryonic/code-diary-releases/releases/download/v1.5.5/code-diary_1.5.5_amd64.deb"

2. 2

   Verify the download against the SHA-512 checksum shown on the downloads page:

   Verify the checksum

   Copy

   sha512sum code-diary_1.5.5_amd64.deb

3. 3

   Install it. On Ubuntu 22.04+ apt resolves dependencies for you. After it finishes, search for "Code Diary" in your application launcher:

   Install the .deb

   Copy

   sudo apt install "./code-diary_1.5.5_amd64.deb"

4. 4

   Optional — add a clickable shortcut to your Desktop by copying the installed launcher and marking it executable:

   Add a Desktop shortcut

   Copy

   cp /usr/share/applications/code-diary.desktop ~/Desktop/
   chmod +x ~/Desktop/code-diary.desktop

   Then right-click the icon on your Desktop and choose "Allow Launching" to activate it.

5. 5

   On newer Ubuntu (23.10, 24.04, 26.04+), strict AppArmor blocks Electron’s sandbox and the app can crash on launch with a SIGTRAP / Signal 5 error. Append --no-sandbox to the launcher to fix it:

   Fix launch on newer Ubuntu

   Copy

   sudo sed -i 's|Exec="/opt/Code Diary/code-diary" %U|Exec="/opt/Code Diary/code-diary" --no-sandbox %U|' /usr/share/applications/code-diary.desktop

   If you also copied the shortcut to your Desktop, run the same replacement on ~/Desktop/code-diary.desktop (without sudo).

6. 6

   Prefer no system install (Fedora, Arch, or other distros)? Use the portable AppImage instead — download it, mark it executable, and run it:

   Download and run the AppImage

   Copy

   wget "https://github.com/Ambryonic/code-diary-releases/releases/download/v1.5.5/Code.Diary-1.5.5.AppImage"
   chmod +x "Code.Diary-1.5.5.AppImage"
   ./"Code.Diary-1.5.5.AppImage"

   If your distro restricts user namespaces, launch with ./"Code.Diary-1.5.5.AppImage" --no-sandbox. If it complains about FUSE: Ubuntu/Debian → sudo apt install libfuse2, Fedora → sudo dnf install fuse, Arch → sudo pacman -S fuse2.

7. 7

   Launch Code Diary, sign in with your Ambryonic account, then create or sync your first group and test the copy action.