Ubiquiti Employee
Posts: 2,970
Registered: ‎10-05-2015
Kudos: 1158
Solutions: 232

UCRM Installation Instructions

[ Edited ]

Welcome to the UCRM Installation guide. New UCRM can be deployed as a docker image on your own server. Please, choose your system and follow the instructions.

 

Knowledge Base Article - UCRM Installation Guide

 

Ubuntu 16.04 (LTS)

Run this command to install docker, pull the UCRM image and start it.

curl -fsSL https://raw.githubusercontent.com/Ubiquiti-App/UCRM/master/install.sh > /tmp/ucrm_install.sh && sudo bash /tmp/ucrm_install.sh


Note: By default, the installation script ensures that the application data (database, pictures, invoices, encryption key, etc.) will be stored outside the docker container (/home/ucrm/postgres and /home/ucrm/data). This will enable you to backup that data and more importantly, this will enable you to perform any future UCRM upgrades without any data loss.

When done the UCRM can be found at http://localhost/ or http://localhost:8080/.

 

Debian 8.4

Run these commands to download and run the installation script which will install docker, pull the UCRM image and start it.

su root
apt-get update
apt-get install curl -y
curl -fsSL https://raw.githubusercontent.com/Ubiquiti-App/UCRM/master/install.sh > /tmp/ucrm_install.sh && bash /tmp/ucrm_install.sh


Note: By default, the installation script ensures that the application data (database, pictures, invoices, encryption key, etc.) will be stored outside the docker container (/home/ucrm/postgres and /home/ucrm/data). This will enable you to backup that data and more importantly, this will enable you to perform any future UCRM upgrades without any data loss.

When done the UCRM can be found at http://localhost/ or http://localhost:8080/.

 

Windows, OS X

Unfortunately, Docker does not provide full support for these systems. Thus we can't ensure smooth backups and upgrades. At this moment we recommend to install VirtualBox with latest version of Ubuntu and then follow the Ubuntu instructions above.

 

-Edited with new revised instructions: 7-22-2016; Added KB Article Link 1-17-2017

New Member
Posts: 35
Registered: ‎01-31-2014
Kudos: 1

Re: UCRM Installation Instructions

is there a way to get this to run in unRAID? i tried pulling it and i get following; 

 


[PDOException]
SQLSTATE[08006] [7] could not translate host name "postgresql" to address: Name does not resolve


Building Elastic search index in background.
UCRM migration complete
/usr/src/ucrm/scripts/backup_database.sh
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.
postgresql:5432 - no attempt
Waiting for PostgreSQL.

Ubiquiti Employee
Posts: 2,970
Registered: ‎10-05-2015
Kudos: 1158
Solutions: 232

Re: UCRM Installation Instructions

@washpc Currently we support Ubuntu and Debian 8.4. Although unraid may work, it is not something we have tested and support. It looks like that error indicates there is a hostname resolution error for postgresql that you can look into more. If you have more trouble try one of the OS's above or post a new thread.

SuperUser
Posts: 4,972
Registered: ‎05-02-2008
Kudos: 4210
Solutions: 37

Re: UCRM Installation Instructions

Wow, Ubuntu 14.0.4 LTS  is a fail ? Brutal. So now a small makework project becomes a server overhaul or a roll of the dice ?  Is there really no way to install this without the docker ?

Professional wasp wrangler
Regular Member
Posts: 383
Registered: ‎03-04-2015
Kudos: 55
Solutions: 1

Re: UCRM Installation Instructions

Well, this seems to be geared more for the Professionals ... since we don't have a server with ubuntu or debian and we are running the billing from our Windows in AirCRM, which I saw will expire at the end of September ... not sure what we are going to do yet.

Member
Posts: 227
Registered: ‎11-23-2014
Kudos: 163
Solutions: 5

Re: UCRM Installation Instructions

[ Edited ]

@ZeRo-cOol wrote:

Well, this seems to be geared more for the Professionals ... since we don't have a server with ubuntu or debian and we are running the billing from our Windows in AirCRM, which I saw will expire at the end of September ... not sure what we are going to do yet.


It's not that hard, I'm not a WISP myself but I act like one to my own shops, so I'm not what you call "a professional" but, still, I went and got an cheap All-in-One from Lenovo for under 4000MXN (a little over 200USD, taxes included) and installed a fresh copy of Linux over a very barebones version of Windows 10 it came with and got myself running in less than a three hours, trip to City Club (sort of like Costco or Sam's) included.

 

Even if you don't have all the networking hardware in place, think of it as an accounting solution, support from the community is great, although a bit limited seeing it is a new platform.

Ubiquiti Employee
Posts: 2,970
Registered: ‎10-05-2015
Kudos: 1158
Solutions: 232

Re: UCRM Installation Instructions

@vitaprimo Nice to hear you got things up and running nicely. @ZeRo-cOol We are here to help, start a new thread if you need something specific.

New Member
Posts: 18
Registered: ‎03-17-2015
Kudos: 1

Re: UCRM Installation Instructions

Hi,

 

I'm trying to install Ubuntu 16.04 LTS, but I got this error:

 

dvadmin@VirtualBox:~/ucrm$ curl -fsSL https://raw.githubusercontent.com/U-CRM/billing/master/install.sh | sudo sh
Download and install Docker
apparmor is enabled in the kernel and apparmor utils were already installed
+ sh -c apt-key adv --keyserver hkp://ha.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
Executing: /tmp/tmp.0mPGu72xnA/gpg.1.sh --keyserver
hkp://ha.pool.sks-keyservers.net:80
--recv-keys
58118E89F3A912897C070ADBF76221572C52609D
gpg: requisitando chave 2C52609D de servidor hkp - ha.pool.sks-keyservers.net
gpg: chave 2C52609D: "Docker Release Tool (releasedocker) <docker@docker.com>" sem alterações
gpg: Número total processado: 1
gpg:              não modificados: 1
+ break
+ sh -c apt-key adv -k 58118E89F3A912897C070ADBF76221572C52609D >/dev/null
+ sh -c mkdir -p /etc/apt/sources.list.d
+ dpkg --print-architecture
+ sh -c echo deb [arch=amd64] https://apt.dockerproject.org/repo ubuntu-xenial main > /etc/apt/sources.list.d/docker.list
+ sh -c sleep 3; apt-get update; apt-get install -y -q docker-engine
Atingido:1 http://ao.archive.ubuntu.com/ubuntu xenial InRelease
Atingido:2 http://security.ubuntu.com/ubuntu xenial-security InRelease                
Atingido:3 http://ao.archive.ubuntu.com/ubuntu xenial-updates InRelease
Atingido:4 http://ao.archive.ubuntu.com/ubuntu xenial-backports InRelease
Atingido:5 https://apt.dockerproject.org/repo ubuntu-xenial InRelease
E: Não foi possível obter acesso exclusivo a /var/lib/dpkg/lock - open (11: Recurso indisponível temporariamente)
E: Não foi possível obter acesso exclusivo ao directório de administração (/var/lib/dpkg/), outro processo está a utilizá-lo?
E: Não foi possível obter acesso exclusivo a /var/lib/dpkg/lock - open (11: Recurso indisponível temporariamente)
E: Não foi possível obter acesso exclusivo ao directório de administração (/var/lib/dpkg/), outro processo está a utilizá-lo?
Docker not installed. Please check previous logs. Aborting.

Can anyone help me solve this situation
Thank you

Regular Member
Posts: 719
Registered: ‎11-10-2012
Kudos: 86
Solutions: 16

Re: UCRM Installation Instructions

Is UCRM (billing) able to run on a UCRM Point yet?

Even for a small number of clients (eg. 10-20) , Or are the devices specs too low?

Ubiquiti Employee
Posts: 1,446
Registered: ‎03-21-2016
Kudos: 237
Solutions: 159

Re: UCRM Installation Instructions

Hello @domingosvarela, could you please try running the install script in this way:

 

curl -fsSL https://raw.githubusercontent.com/U-CRM/billing/master/install.sh > /tmp/ucrm_install.sh && sudo bash /tmp/ucrm_install.sh

 

New Member
Posts: 18
Registered: ‎03-17-2015
Kudos: 1

Re: UCRM Installation Instructions

[ Edited ]

Hi @UBNT-Ondra,

Many Thanks, now is working, the installation was completed successfully, a new issue, the currency of my country is not available in the list.
Angola (AOA) - AKz

 

 

Ubiquiti Employee
Posts: 1,446
Registered: ‎03-21-2016
Kudos: 237
Solutions: 159

Re: UCRM Installation Instructions

You're welcome. Your currency will be added in next release.

New Member
Posts: 18
Registered: ‎03-17-2015
Kudos: 1

Re: UCRM Installation Instructions

@UBNT-Ondra Thanks so much!

It is predicted in the next release be the language packs "Portuguese"?

BR

Ubiquiti Employee
Posts: 4,054
Registered: ‎12-10-2015
Kudos: 1436
Solutions: 312

Re: UCRM Installation Instructions

@domingosvarela Talking about internationalization, portuguese is one of our top priority. However we will start adding new translations when the basic set of UCRM features are accomplished, eg. end of summer.

New Member
Posts: 2
Registered: ‎02-12-2016

How should my client to enter the area UCRM-client software?

I managed to run the ucrm but I need to know how to enter my client to see your bill in the customer portal, although the platform supposedly sent the email to the user with information on how to enter, the mail client not nothing has come ...

I appreciate if someone has already achieved and to guide me thank you very much.

 

 

 

he conseguido hacer funcionar el ucrm pero necesito saber como debe ingresar mi cliente para que vea su factura en el portal de cliente, a pesar de que la plataforma supuestamente envio el correo al usuario con la informacion de como debe ingresar, al correo del cliente no ha llegado nada...

 
agradezco si alguien ya lo ha conseguido y pueda orientarme muchas gracias.
Member
Posts: 227
Registered: ‎11-23-2014
Kudos: 163
Solutions: 5

Re: How should my client to enter the area UCRM-client software?

[ Edited ]

@alexciber94

Si ya configuraste la información de servidor básica de tu servidor UCRM de puertos e IP al hacerle la invitación al cliente le llega un link para que abra su cuenta. Tienes que haber configurado la dirección IP del servidor UCRM primero, si el cliente está fuera de la intranet tienes que configurar puertos en el enrutador, también no olvides configurar la información de tu servidor de email, por ejemplo; yo uso Zoho Mail, así que tengo que configurar smtp.zoho.com en el servidor SMTP.

 

Para probar, puedes agregarte con otra dirección de email tuya y te envías el email de invitación para que veas cómo se ve desde la perspetiva del cliente.

 

La información de servidor de email está en General > Settings > System > Mailer.
Antes tmb revisa que la información en General > Settings > System > Application esté correcta.

Ubiquiti Employee
Posts: 4,054
Registered: ‎12-10-2015
Kudos: 1436
Solutions: 312

Re: How should my client to enter the area UCRM-client software?

@alexciber94 You should set up UCRM properly before you start inviting clients. Gracias @vitaprimo por explicarlo Man Happy 

 

I would just sum up what should be set:

 

1) Mailer: set up the mailer connection and try it is working - Settings > General > System > Mailer

2) Application: set up IP and/or Domain name for the server where your UCRM is running (This will be used in the invitaion email) - Settings > General > System > Application 

3) Notification: optionally - set up the text message used for the Invitation email. - Settings > General > Notifications

New Member
Posts: 2
Registered: ‎02-12-2016

Re: UCRM Installation Instructions

@vitaprimo y @UBNT-Petr muchas gracias por la información pues verán soy un poco nuevo en este tema de los puertos y servidores e incluso en algunos conceptos de WISP pero aun asi lo voy a intentar y les comento como me va, para que por favor si no es mucha molestia me sigan orientando... Muchas gracias
New Member
Posts: 2
Registered: ‎02-17-2014

Re: UCRM Installation Instructions

Hi!

I am trying to install UCRM on a fresh Ubuntu 16.04 LTS, but i get the following error:

curl -fsSL https://raw.githubusercontent.com/U-CRM/billing/ma​ster/install.sh > /tmp/ucrm_install.sh && sudo bash /tmp/ucrm_install.sh

curl: (22) The requested URL returned error: 400 Bad Request

 

 

 

New Member
Posts: 18
Registered: ‎03-17-2015
Kudos: 1

Re: UCRM Installation Instructions

Hi,

 

Try this command, it worked for me.

 

curl -fsSL https://raw.githubusercontent.com/U-CRM/billing/master/install.sh > /tmp/ucrm_install.sh && sudo bash /tmp/ucrm_install.sh