Table of Contents
![Install Focalboard on Ubuntu - Kanban Project Management](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-install-on-ubuntu-1024x538.jpg)
Focalboard is a kanban project management solution by the same team that develops the Mattermost team communication application. The free kanban board software is a lightweight, open-source cloud project management server solution available for personal computers and Ubuntu Server.
Install Focalboard Kanban on Ubuntu Server
- Log into SSH.
- Find the latest Focalboard version from GitHub and select the “Assets” link to show available downloads.
We’ll be using v0.9.1 – RC1, the latest as of September 17, 2021. Right-click the focalboard-server-linux-amd64.tar.gz file and copy the link. In SSH, use the wget command with that GitHub URL: - Extract the tar file:
- Move the extracted directory to your /opt directory:
- Focalboard uses SQLite by default but can be configured with PostgreSQL or MySQL. To continue with SQLite, skip to step 9. To use a database management system, create a new database and database user with your preferred database system.
- Edit the Focalboard configuration file:
- Find the following lines:
"dbconfig": "./focalboard.db",
"postgres_dbconfig": "dbname=focalboard sslmode=disable",
Change the two lines according to the database system you use, replacing “db-user:db-user-password” with your database user and database user password.
PostgreSQL:
MySQL: - Save changes.
- Create a service file to auto-run the kanban software after system restarts:
- Add the following to the new file:
- Save changes.
- Open port 8000 in your firewall. We used ConfigServer Security & Firewall (CSF) for this tutorial.
- Reload Systemd:
- Start the Focalboard service:
- Set the Focalboard service to run after system restarts:
- We recommend installing an SSL certificate for your domain. You can create free SSL certs with Certbot. InMotion Cloud Server Hosting customers should use PIP to install Certbot as Snapd is unsupported at this time.
(Optional) Configure NGINX
The Focalboard developers recommend installing NGINX to proxy requests from port 80. If you choose to do so, follow the steps below. If not, skip to the next section to create an admin user.
- Install NGINX:
- Create an NGINX site file:
- Copy the NGINX configuration data:
- Change the “server_name” to your server hostname.
- Save changes.
- If there is a default site fileBoard Templates, remove it:
- Link the Focalboard site files:
- Test your NGINX configuration setup:
- Reload NGINX:
Create an Admin Focalboard User
Visit your kanban URL in a web browser (e.g. example.servername.com:8000). You should see a login screen. Select “or create an account if you don’t have one.”
![Focalboard login page](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-login.png)
Enter your email address, username, and strong password. Then select “Register” to create the account and log into your Focalboard kanban application.
![Focalboard "Sign up for your account" page](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-signup.png)
Congratulations on successfully installing your kanban board application.
![Blank Focalboard without boards](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-blank-1024x576.png)
How to Use Focalboard
In this section we’ll cover how to create and manage boards.
Board Templates
![Focalboard "Select a template" menu](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-templates.png)
Once you log into Focalboard, select “+ Add Board” in the bottom-left corner and choose a board template to get started:
- Meeting Notes
- Personal Goals
- Personal Tasks
- Project Tasks
- Roadmap
- Empty Board
Below are screenshots of the board templates in their default view.
![Meeting Notes Focalboard board](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-meeting-notes-1024x344.png)
![Personal Goals Focalboard board](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-personal-goals-1024x398.png)
![Personal Tasks Focalboard board](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-personal-tasks-1024x434.png)
![Roadmap Focalboard board](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-roadmap-1024x442.png)
![Empty Focalboard board](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-empty-board-1024x418.png)
We’ll use “Project Tasks” since it already has the necessary statuses, priorities, and swimlanes for the most common kanban model.
![Project Tasks Focalboard board](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-project-tasks-1024x420.png)
At the top you can select the board icon or name to make changes. A lot of emojis are included.
The different views options are on the left:
- All Tasks (list of tasks with status and priority)
- By Priority (columns per priority level)
- By Status (Usual swimlanes including “Next up,” “In Progress,” “Completed,” and “Archived”)
Each view has options to filter and search through tasks and toggle viewing status, priority, and creation date in boards.
Kanban Board Management
You can select “+” or “+ New” under a swimlane to add an untitled task card. There you can customize:
- Task icon
- Task name
- Status
- Priority
- New properties for additional info and sorting opportunities such as contact info and URL
- Comments
- Description
Select the “X” in the upper-left corner to close the card details. Changes are saved automatically.
![New Focalboard task options](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-new-task-1024x520.png)
You can drag-and-drop cards between columns to change the status.
Focalboard User and Kanban Settings
Below we’ll cover system-wide settings available for user accounts.
User Settings
Selecting the “Focalboard” link in the upper-left corner displays a menu with the following options:
- Log out
- Change your password
- Invite more users with an one-time use special token URL
The admin account must invite additional users to use Focalboard as of version 0.9.1.
Focalboard Settings
![Focalboard settings menu](https://www.inmotionhosting.com/support/wp-content/uploads/2021/09/focalboard-settings.png)
Select “Settings” from the bottom-left corner for the following system settings:
- Import an archive of another Focalboard instance
- Export an archive of the current instance to a formatted text file
- Set the language of the kanban system between over ten options
- Set the theme between the default, light, or dark appearance
- Toggle displaying random icons throughout kanban boards and tasks
If you forget your admin password, follow official documentation at https://www.focalboard.com/guide/admin/#resetting-passwords. Don’t forget to make the file executable:
Learn more about managing your Linux VPS with our Cloud Server Hosting Product Guide.
No matter if you're a developer, system administrator, or simply a fan of SSH and command line, InMotion's Cloud Hosting plans provide a fast, scalable environment that is budget-friendly.