Română · English

Instalarea pe un server

De la un server Debian sau Ubuntu gol până la asistentul de instalare, comandă cu comandă.

Instalatorul pregătește un server Debian sau Ubuntu dintr-o singură comandă: pachetele, baza de date, cheile private și cele două servicii. Apoi pui HTTPS în fața lui și deschizi adresa în browser.

Clonează repository-ulîn /opt/opensolr-accountingRulează install.shpachete, bază de date, chei,serviciiPune HTTPS în fațăApache sau nginx, dupăexempleDeschide adresaasistentul de instalare ceretokenul de instalare Clonează repository-ulîn /opt/opensolr-accountingRulează install.shpachete, bază de date, chei,serviciiPune HTTPS în fațăApache sau nginx, dupăexempleDeschide adresaasistentul de instalare ceretokenul de instalare

Instalatorul face partea de server; HTTPS-ul din fața lui îl pui tu, după exemplele din repository.

01 · De ce ai nevoie
  • Un server Debian sau Ubuntu la care ai acces ca root.
  • Un nume de host îndreptat spre server, de exemplu accounting.example.com, și un certificat HTTPS pentru el.
  • Apache sau nginx, ca să servească aplicația prin HTTPS.
  • Opțional: un cont Opensolr (emailul și cheia API), pe care le cere asistentul de instalare. Fără el toată contabilitatea merge; documentele se păstrează, dar nu sunt citite și nu se caută în ele. Vezi Contul tău Opensolr.

Restul îl aduce instalatorul singur: Python și PostgreSQL. Repository-ul cere Python 3.12 sau mai nou și PostgreSQL 15 sau mai nou.

02 · Rulează instalatorul

Ca root, înlocuind accounting.example.com cu numele tău de host:

git clone https://github.com/phpcip/opensolr-accounting.git /opt/opensolr-accounting
cd /opt/opensolr-accounting
sudo ./install/install.sh accounting.example.com

Instalează Python și PostgreSQL, face un utilizator de serviciu și baza de date, scrie un fișier privat de setări cu chei generate acum, pregătește un folder privat pentru documente, creează tabelele și pornește două servicii: opensolr-accounting-web (aplicația) și opensolr-accounting-worker (lucrul din fundal). La final afișează tokenul de instalare. Aplicația rulează acum pe server, pe 127.0.0.1:8765, și nu se poate accesa din afară până la pasul următor.

03 · Pune HTTPS în față

Cu Apache

Repository-ul are un virtual host gata făcut pentru Apache și unul pentru nginx. Copiază-l, pune în el numele tău de host și activează-l. Se așteaptă ca certificatul să fie în /etc/letsencrypt/live/<host>/; dacă al tău e în altă parte, schimbă cele două linii ale certificatului.

cp /opt/opensolr-accounting/deploy/apache-vhost.conf.example /etc/apache2/sites-available/opensolr-accounting.conf
sed -i 's/accounting.example.com/YOUR.HOST.NAME/g' /etc/apache2/sites-available/opensolr-accounting.conf
a2enmod ssl proxy proxy_http headers rewrite
a2ensite opensolr-accounting
apache2ctl configtest
systemctl reload apache2

Sau cu nginx

cp /opt/opensolr-accounting/deploy/nginx-vhost.conf.example /etc/nginx/sites-available/opensolr-accounting
sed -i 's/accounting.example.com/YOUR.HOST.NAME/g' /etc/nginx/sites-available/opensolr-accounting
ln -s /etc/nginx/sites-available/opensolr-accounting /etc/nginx/sites-enabled/opensolr-accounting
nginx -t
systemctl reload nginx

Ambele exemple primesc fișiere încărcate de până la 500 MB și dau unei cereri până la 300 de secunde.

04 · Deschide-l

Deschide https://YOUR.HOST.NAME/. Orice pagină duce la asistentul de instalare până când acesta e terminat. Asistentul cere tokenul de instalare; dacă nu-l mai ai pe ecran, citește-l din nou pe server:

cat /var/lib/opensolr-accounting/setup-token

Ca să vezi că ambele servicii rulează:

systemctl status opensolr-accounting-web opensolr-accounting-worker

Opensolr Accounting este open source, sub licența GNU Affero General Public License v3.0. Întrebările despre contul Opensolr, indexurile Opensolr sau plan merg la opensolr.com/contact; cele despre programul în sine, pe GitHub.

Documentația Opensolr Accounting