Jump to content
Aperture Development

FriendUP Docker - Joining the Shipyard

Recommended Posts

Hello everyone,

Today I finished my work on the FriendUP Docker project, allowing people to safely dock a application into their system.

What is Docker?

Docker is a awesome way to deploy and run applications by using so called containers. A container allows developers to package an application with everything it needs to work flawlessly. No more "Missing requirement" or "System incompability", because all ressources as well as the OS are shipped with the container. Sounds like a VM right? Well, kinda. The main difference to a VM is that a container doesn't require allocated ressources, it can use the same ressources as the system it runns on, as well as the kernel. This allows us to integrate new applications into our system easily, without having to install another os or setting up a vm. Just one command alone can deploy a whole OS in minutes, for example you want ubuntu on your Debian machine docker run -it ubuntu:18.04 /bin/bash thats it

How to deploy FriendUP-Docker


First of all you require Docker and Docker-Compose, you can get it from here:
https://docs.docker.com/install/ 

https://docs.docker.com/compose/install/

Then you just follow these easy steps and you are good to go

  1. Download or Git Clone the FriendUP-Docker repository from here:  https://github.com/Aperture-Development/friendup-docker
  2. Change the .env file and insert your configuration
  3. Navigate into the folder and type "docker-compose up"
  4. After a few minutes, FriendCore should be starting and you should be able to reach Friend on port 6502

Please notice that this will create a Container for FriendUP and one for MariaDB, it is not necessary to pre-create any mysql data besides the settings in the .env file

You might want to setup a reverse proxy for Friend. That way you can keep port 6502 closed to the outside and use a regular subdomain with ssl from your apache or nginx server. Here is a usefull guide how to create a reverse proxy with Apache: https://www.digitalocean.com/community/tutorials/how-to-use-apache-http-server-as-reverse-proxy-using-mod_proxy-extension

Environment Variables

MYSQL_USER - The Username of the FriendUP Database user
MYSQL_PASSWORD - The Password for the FriendUP Database user
MYSQL_DATABASE - The name of the FriendUP Database
MYSQL_ROOT_PASSWORD - The password of the root database user of the friendup-db container
DOCKER_FRIEND_DOMAIN - The domain under which Friend will be reachable ( please also include a port if you don't use a reverse proxy )

Updating FriendUP

To update FriendUP, go back to the location of the docker-compose file using a cli and type "docker-compose down". This will stop the containers and remove them ( Don't worry, your data is safe ). After you done that, just type "docker-compose up" again and the container should be updated

Additional Info

FriendUP: https://github.com/FriendUPCloud/friendup
Docker: https://www.docker.com/
Docker-Compose: https://docs.docker.com/compose/
DockerHub: https://hub.docker.com/r/aperturedevelopment/friendup

The Docker-Friend project is licenced under MIT.

The FriendUP-Docker container has been made by Aperture Development. We are in no way owning or claiming ownership over FriendUP and it's code.

Share this post


Link to post
Share on other sites

Thank you so much! I am sure this will be a huge contribution to the community and I hope we can keep updating this with each substantial update to the Friend codebase.

  • Thanks 1

Share this post


Link to post
Share on other sites
Guest
This topic is now closed to further replies.

×
×
  • Create New...