mirror of
https://framagit.org/les/gancio.git
synced 2025-02-01 09:02:01 +01:00
379 lines
13 KiB
HTML
379 lines
13 KiB
HTML
<!DOCTYPE html>
|
|
|
|
<html lang="en-US">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=Edge">
|
|
|
|
<title>Debian - Gancio</title>
|
|
|
|
|
|
|
|
<link rel="shortcut icon" href="https://gancio.org/favicon.ico" type="image/x-icon">
|
|
<link rel="stylesheet" href="https://gancio.org/assets/css/just-the-docs.css">
|
|
<link rel="stylesheet" href="https://gancio.org/assets/css/style.css">
|
|
|
|
|
|
<script type="text/javascript" src="https://gancio.org/assets/js/vendor/lunr.min.js"></script>
|
|
|
|
|
|
<script type="text/javascript" src="https://gancio.org/assets/js/just-the-docs.js"></script>
|
|
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
|
|
<script src="https://gancio.org/assets/js/jquery-3.3.1.min.js"></script>
|
|
<link rel="stylesheet" href="https://gancio.org/assets/css/jquery.fancybox.min.css"/>
|
|
<script src="https://gancio.org/assets/js/jquery.fancybox.min.js"></script>
|
|
|
|
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
|
<title>Debian | Gancio</title>
|
|
<meta name="generator" content="Jekyll v3.8.6" />
|
|
<meta property="og:title" content="Debian" />
|
|
<meta property="og:locale" content="en_US" />
|
|
<meta name="description" content="A shared agenda for local communities with AP support" />
|
|
<meta property="og:description" content="A shared agenda for local communities with AP support" />
|
|
<link rel="canonical" href="https://gancio.org/install/debian" />
|
|
<meta property="og:url" content="https://gancio.org/install/debian" />
|
|
<meta property="og:site_name" content="Gancio" />
|
|
<script type="application/ld+json">
|
|
{"@type":"WebPage","url":"https://gancio.org/install/debian","headline":"Debian","description":"A shared agenda for local communities with AP support","@context":"https://schema.org"}</script>
|
|
<!-- End Jekyll SEO tag -->
|
|
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<div class="page-wrap">
|
|
<div class="side-bar">
|
|
<a href="https://gancio.org/" class="site-title fs-6 lh-tight">Gancio</a>
|
|
<span class="fs-3"><button class="js-main-nav-trigger navigation-list-toggle btn btn-outline" type="button" data-text-toggle="Hide">Menu</button></span>
|
|
<div class="navigation main-nav js-main-nav">
|
|
<nav role="navigation" aria-label="Main navigation">
|
|
<ul class="navigation-list">
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item active">
|
|
|
|
<a href="https://gancio.org/404.html" class="navigation-list-link"></a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item">
|
|
|
|
<a href="https://gancio.org/" class="navigation-list-link">Home</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item active">
|
|
|
|
<a href="https://gancio.org/install" class="navigation-list-link">Install</a>
|
|
|
|
|
|
<ul class="navigation-list-child-list ">
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item active">
|
|
|
|
<a href="https://gancio.org/install/debian" class="navigation-list-link active">Debian</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li class="navigation-list-item ">
|
|
|
|
<a href="https://gancio.org/install/docker" class="navigation-list-link">Docker</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item ">
|
|
|
|
<a href="https://gancio.org/install/nginx" class="navigation-list-link">Nginx</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item">
|
|
|
|
<a href="https://gancio.org/config" class="navigation-list-link">Configuration</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item">
|
|
|
|
<a href="https://gancio.org/dev" class="navigation-list-link">Hacking</a>
|
|
|
|
|
|
<ul class="navigation-list-child-list ">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item ">
|
|
|
|
<a href="https://gancio.org/dev/locales" class="navigation-list-link">Support a new language</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
<li class="navigation-list-item ">
|
|
|
|
<a href="https://gancio.org/dev/migration" class="navigation-list-link">Migration</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item ">
|
|
|
|
<a href="https://gancio.org/dev/structure" class="navigation-list-link">Project Structure</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item">
|
|
|
|
<a href="https://gancio.org/instances" class="navigation-list-link">Instances</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item">
|
|
|
|
<a href="https://gancio.org/about" class="navigation-list-link">About</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="navigation-list-item">
|
|
|
|
<a href="https://gancio.org/federation" class="navigation-list-link">Federation</a>
|
|
|
|
</li>
|
|
|
|
|
|
|
|
</ul>
|
|
</nav>
|
|
|
|
</div>
|
|
<footer role="contentinfo" class="site-footer">
|
|
<p class="text-small text-grey-dk-000 mb-0">This site uses <a href="https://github.com/pmarsceill/just-the-docs">Just the Docs</a>, a documentation theme for Jekyll.</p>
|
|
</footer>
|
|
</div>
|
|
<div class="main-content-wrap js-main-content" tabindex="0">
|
|
<div class="page-header">
|
|
<div class="main-content">
|
|
|
|
<div class="search js-search">
|
|
<div class="search-input-wrap">
|
|
<input type="text" class="js-search-input search-input" tabindex="0" placeholder="Search Gancio" aria-label="Search Gancio" autocomplete="off">
|
|
<svg width="14" height="14" viewBox="0 0 28 28" xmlns="http://www.w3.org/2000/svg" class="search-icon"><title>Search</title><g fill-rule="nonzero"><path d="M17.332 20.735c-5.537 0-10-4.6-10-10.247 0-5.646 4.463-10.247 10-10.247 5.536 0 10 4.601 10 10.247s-4.464 10.247-10 10.247zm0-4c3.3 0 6-2.783 6-6.247 0-3.463-2.7-6.247-6-6.247s-6 2.784-6 6.247c0 3.464 2.7 6.247 6 6.247z"/><path d="M11.672 13.791L.192 25.271 3.02 28.1 14.5 16.62z"/></g></svg>
|
|
</div>
|
|
<div class="js-search-results search-results-wrap"></div>
|
|
</div>
|
|
|
|
|
|
<ul class="list-style-none text-small mt-md-1 mb-md-1 pb-4 pb-md-0 js-aux-nav aux-nav">
|
|
|
|
<li class="d-inline-block my-0 mr-2"><a href="https://blog.gancio.org">Blog</a></li>
|
|
|
|
<li class="d-inline-block my-0 mr-2"><a href="https://framagit.org/les/gancio">Source</a></li>
|
|
|
|
<li class="d-inline-block my-0"><a href="https://socialhub.activitypub.rocks/c/software/gancio">Forum</a></li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
</div>
|
|
<div class="main-content">
|
|
|
|
|
|
<nav class="breadcrumb-nav">
|
|
<ol class="breadcrumb-nav-list">
|
|
|
|
<li class="breadcrumb-nav-list-item"><a href="https://gancio.org/install">Install</a></li>
|
|
|
|
<li class="breadcrumb-nav-list-item"><span>Debian</span></li>
|
|
</ol>
|
|
</nav>
|
|
|
|
|
|
<div id="main-content" class="page-content" role="main">
|
|
<h2 id="debian-installation">Debian installation</h2>
|
|
|
|
<ol>
|
|
<li>Install Node.js & yarn (<strong>from root</strong>)
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-sL</span> https://deb.nodesource.com/setup_12.x | bash -
|
|
apt-get <span class="nb">install</span> <span class="nt">-y</span> nodejs
|
|
curl <span class="nt">-sL</span> https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -
|
|
<span class="nb">echo</span> <span class="s2">"deb https://dl.yarnpkg.com/debian/ stable main"</span> <span class="o">></span> /etc/apt/sources.list.d/yarn.list
|
|
apt-get update <span class="o">&&</span> apt-get <span class="nb">install </span>yarn
|
|
</code></pre></div> </div>
|
|
<p><small><a href="https://github.com/nodesource/distributions/blob/master/README.md">source</a></small></p>
|
|
</li>
|
|
<li>Install Gancio
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>yarn global add gancio <span class="nt">--prod</span>
|
|
</code></pre></div> </div>
|
|
</li>
|
|
<li>Setup with postgreSQL <strong>(optional as you can choose sqlite)</strong>
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>apt-get <span class="nb">install </span>postgresql
|
|
<span class="c"># Create the database</span>
|
|
su postgres <span class="nt">-c</span> psql
|
|
<span class="nv">postgres</span><span class="o">=</span><span class="c"># create database gancio;</span>
|
|
<span class="nv">postgres</span><span class="o">=</span><span class="c"># create user gancio with encrypted password 'gancio';</span>
|
|
<span class="nv">postgres</span><span class="o">=</span><span class="c"># grant all privileges on database gancio to gancio;</span>
|
|
</code></pre></div> </div>
|
|
</li>
|
|
<li>Create a user to run gancio from
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>adduser gancio
|
|
su gancio
|
|
</code></pre></div> </div>
|
|
</li>
|
|
<li>Launch interactive setup
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gancio setup <span class="nt">--config</span> config.json
|
|
</code></pre></div> </div>
|
|
</li>
|
|
<li>Start
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gancio start <span class="nt">--config</span> config.json
|
|
</code></pre></div> </div>
|
|
</li>
|
|
<li>
|
|
<p>Point your web browser to <a href="http://localhost:13120">http://localhost:13120</a> or where you selected during setup.</p>
|
|
</li>
|
|
<li>
|
|
<p><a href="/install/nginx">Setup nginx as a proxy</a></p>
|
|
</li>
|
|
<li>To deploy gancio in production you should use something like <strong><a href="http://pm2.keymetrics.io/">pm2</a></strong>:</li>
|
|
</ol>
|
|
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>yarn global add pm2
|
|
pm2 start gancio <span class="nt">--</span> <span class="nt">--config</span> config.json
|
|
|
|
<span class="c"># Run this command to run your application as a service and automatically restart after a reboot:</span>
|
|
pm2 startup <span class="c"># read the output!</span>
|
|
<span class="nb">sudo </span>pm2 startup <span class="nt">-u</span> gancio
|
|
</code></pre></div></div>
|
|
|
|
<ol>
|
|
<li>Upgrade
|
|
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>yarn global add gancio
|
|
<span class="nb">sudo </span>service pm2 restart
|
|
</code></pre></div> </div>
|
|
</li>
|
|
</ol>
|
|
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|