# How to host a Focalboard server for remote project management

## Introduction <a href="#introduction" id="introduction"></a>

Using productivity tools, such as the open-source project [Focalboard](https://www.focalboard.com/), can be very beneficial. These types of tools provide a centralized platform for organizing and managing tasks and projects, making it easier to stay on track.

Focalboard has an intuitive design and is highly customizable. This control allows you to make a board that is specific to your needs. In addition, Focalboard includes many features and integrations with other platforms, such as [Jira](https://www.atlassian.com/software/jira), which enhances workflow efficiency even further.

However, hosting such a solution can oftentimes be expensive, since you need to pay for a server, domain name, and take care of website security. All of these problems can be overcome by self-hosting the Focalboard server and using Meshnet for secure [remote access](https://nordvpn.com/meshnet/remote-access/). Meshnet allows you to work on [joint projects](https://nordvpn.com/meshnet/joint-projects/) in a private, encrypted network, meaning that your data is secure from unwanted outside connections.

This article contains instructions on how to host a Focalboard server using Docker and how you can invite your peers to the server.

## Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

Since the Focalboard server will be deployed using Docker, you must have Docker installed on your device. Instructions on how to download and install Docker can be found on the Docker website:

* [Docker Desktop instructions for Windows](https://docs.docker.com/desktop/install/windows-install/)
* [Docker Desktop instructions for macOS](https://docs.docker.com/desktop/install/mac-install/)
* [Docker Desktop Instructions for Linux (application with a GUI)](https://docs.docker.com/desktop/install/linux-install/)
* [Docker Engine instructions for Linux (CLI only)](https://docs.docker.com/engine/install/)

## Deploy Focalboard in a Docker container <a href="#deploy-focalboard-in-a-docker-container" id="deploy-focalboard-in-a-docker-container"></a>

With Docker installed on your system, you can proceed with creating and deploying your Focalboard server as a Docker container.

1. Open **Command Prompt** (on Windows) or **Terminal** (on Linux or macOS).
2. Run the following `docker run` command:<br>

   <pre class="language-bash" data-overflow="wrap"><code class="lang-bash">docker run -dit --name focalboard -p 80:8000 --restart always mattermost/focalboard
   </code></pre>

Docker will [pull the Focalboard image](https://docs.docker.com/engine/reference/commandline/pull/) from Docker Hub and deploy the container.

## Set up your Focalboard account <a href="#set-up-your-focalboard-account" id="set-up-your-focalboard-account"></a>

To use and control your Focalboard, you need to connect to its web interface. By default, the interface listens on port 80 (unless configured differently in the `docker run` command).

1. Open your internet browser.

2. In the URL field, enter `localhost/register` and press **Enter** to open the account creation screen.

3. Type in your email, username, and password.<br>

   <div align="left"><figure><img src="https://3559400189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cTezbT2vN0lurEio8Z5%2Fuploads%2F3ey4CwDngp7WscjB233D%2Ffocal_url.png?alt=media&#x26;token=b88d0d91-9f14-471f-b741-aaefac8f0064" alt="Entering the Focalboard account details for registration."><figcaption></figcaption></figure></div>

4. Click **Register**.

Upon registering, you will be redirected to the main Focalboard page. From this page, you can use templates or create your personal boards from scratch.

<div align="left"><figure><img src="https://3559400189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cTezbT2vN0lurEio8Z5%2Fuploads%2FF4oiVA5ENV29KQQZtjce%2Ffocal_dash.png?alt=media&#x26;token=fcf57d89-216a-4ca8-bf7d-9a8dd515c573" alt="Board templates in Focalboard."><figcaption></figcaption></figure></div>

For additional guidelines on how to configure your boards, refer to the [Focalboard documentation](https://www.focalboard.com/guide/user/).

## Invite your Meshnet peers <a href="#invite-your-meshnet-peers" id="invite-your-meshnet-peers"></a>

Due to Focalboard’s design, only the first user account can be created by accessing the web interface directly. All subsequent users must receive invitation links. To send an invitation:

1. Open your Focalboard web interface.
2. Click the **Focalboard** icon in the upper-left corner.
3. Select **Invite users**.\
   \
   ![Clicking 'Invite users'.](https://3559400189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cTezbT2vN0lurEio8Z5%2Fuploads%2FPCyPAGFuqvn5rJhQA4dU%2Ffocal_invite.png?alt=media\&token=b2e84323-7ad7-4261-94ee-8a3bfde171e3)

   &#x20;
4. Click **Copy link** to copy the registration token.\
   \
   ![Clicking 'Copy link'.](https://3559400189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cTezbT2vN0lurEio8Z5%2Fuploads%2FY2ylWy1vp3O3rlItbXfO%2Ffocal_invite_link.png?alt=media\&token=8e8d565e-3fcf-44b3-998a-2a86f44f5e82)

   &#x20;
5. Before sending the link, change the `localhost` part to the Nord name of your Focalboard server.\
   \
   **Example**\
   `http://secret.meerkat-himalayas.nord/register?t=kujqes9o1fjyo9kthgdnzuaa4xw`

After opening the link, your peers need to fill in the registration details to create an account.

## Access Focalboard over Meshnet <a href="#access-focalboard-over-meshnet" id="access-focalboard-over-meshnet"></a>

{% hint style="info" %}
**Note**

If you're hosting Focalboard on a Linux device, you must grant the [local network permission](https://meshnet.nordvpn.com/features/explaining-permissions/local-network-permissions) for the devices accessing it. For more information, see [Common issues on Linux](https://meshnet.nordvpn.com/troubleshooting/linux#cannot-access-docker-containers-over-meshnet).
{% endhint %}

To access the Focalboard server using Meshnet follow these steps:

1. Copy the Nord name of the Focalboard server directly from the NordVPN app.
2. Open your internet browser.
3. Paste the copied Nord name followed by a slash (/) to the URL field and press **Enter**.\
   \
   **Example**\
   `secret.meerkat-himalayas.nord/`<br>
4. Enter your account details and click **Log in**.

Now you can access the Focalboard server from any device, using any network around the world.

<div align="left"><figure><img src="https://3559400189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0cTezbT2vN0lurEio8Z5%2Fuploads%2F8lXEsMAIQcFCZ4NpYAuL%2Ffocal_mesh.png?alt=media&#x26;token=c27f187f-0da3-4f94-bd61-6467586469fd" alt="Focalboard dashboard accessed using the Nord name."><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://meshnet.nordvpn.com/how-to/joint-projects/focalboard-project-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
