focalboard-install/README.md

45 lines
2.0 KiB
Markdown

## Focalboard install script for Ubuntu 22.04 server
### Prerequisites
An Ubuntu 22.04 server with Nginx and MariaDB.\
Nginx can be installed from
[\[Here\]](https://git.x-files.dk/ubuntu-server-apps/nginx-install)
and MariaDB can be install from
[\[Here\]](https://git.x-files.dk/ubuntu-server-apps/mariadb-install)
### Download the script
```
git clone https://git.x-files.dk/ubuntu-server-apps/focalboard-install.git
```
### Usage
cd focalboard-install
sudo ./focalboardinstall [-n] <domain name> [-d] <focal database name> [-u] <focal database user> [-p] <focal database pwd>
### Example
sudo ./focalboardinstall -n focal.something.xyz -d focaldbname -u focaldbuser -p focaldbpassword
This will create a Focalboard site running on port 80 with the domain name you chose under the installation.
Don't worry though this can easily be fixed by modifying the Nginx configuration later.
If you need an example on how to configure Nginx to run this on port 443 I an example
[\[Here\]](https://git.x-files.dk/ubuntu-server-files/nginx-config-examples/src/branch/main/focalboard.443.conf)
### Configuration
Once the script is done browse to http://<i></i>focal.something.xyz and select create new user. The first user will become the admin account. All other users will be created using an invite link from the admin account.
### Post install
Nothing to do.
### Troubleshooting
Most issues will probably be caused by the fact that we all set up and configure Nginx diffrently. If you encounter problems I would suggest you look at the Nginx configuration I use
[\[Here\]](https://git.x-files.dk/ubuntu-server-apps/nginx-install/src/branch/main/cfg/nginx.conf)
and also the default "sites-enabled" Nginx configurarion I use
[\[Here\]](https://git.x-files.dk/ubuntu-server-apps/nginx-install/src/branch/main/cfg/default)
when you start troubleshooting.
### More guides
More guides can be found on [\[wiki.xfiles.dk\]](https://wiki.x-files.dk)
### Last tested
January 12th 2024 on Ubuntu 22.04.