turn markdown install pages into html

master
alice 3 years ago
parent f72b098f5e
commit d48b48aad1

@ -88,6 +88,13 @@ def page(request, name):
basename + '.md', basename + '.md',
] ]
try:
#html_template = get_template(basename + '.html')
return render(request, basename + '.html')
except TemplateDoesNotExist as e:
print(basename + '.html', "not found, looking for md", repr(e))
pass
for file in files: for file in files:
try: try:
template = get_template(file) template = get_template(file)

@ -7,7 +7,7 @@ register = template.Library()
BUTTON_HTML = """ BUTTON_HTML = """
<a class="pure-button pure-button-primary download-button" href="{url}">{title}</a> <a class="pure-button pure-button-primary download-button" href="{url}">{title}</a>
[(sig)]({url}.asc) <a href="{url}.asc">(sig)</a>
""" """
@register.simple_tag @register.simple_tag

@ -35,6 +35,15 @@ pre {
margin-bottom: 1em; margin-bottom: 1em;
} }
code.codeblock {
font-family: monospace;
display: block;
line-height: 125%;
padding: 0.25em 0.75em;
margin: 0.25em;
border-left: 3px solid #1c619a;
}
div#captcha > div { div#captcha > div {
margin: 1em auto; margin: 1em auto;
} }
@ -301,7 +310,10 @@ header .site-menu a{
} }
.content h3 { .content h3 {
font-size: 1em; font-weight: 400;
text-align: left;
font-size: 1.2em;
margin: 1em;
} }
.flex-page { .flex-page {
@ -606,6 +618,32 @@ ul.errorlist {
color: #0b2d4f; color: #0b2d4f;
} }
.install-section h3 {
margin: 0.25em 0;
}
.install-section > p {
font-size: 0.9em;
text-align: justify;
margin: 0.25em 0;
}
.install-section hr {
width: 75%;
margin: 1.5em auto;
}
.install-instructions ol, .install-instructions ul {
padding-left: 1.5em;
}
.install-instructions > ol > li {
margin: 1em 0;
}
.install-section ol ul > li {
margin: 0.25em 0;
}
.install-instructions img {
display: block;
margin: 0.5em;
}
.page > .content > p { .page > .content > p {
margin: 1.5em 0; margin: 1.5em 0;
} }
@ -900,6 +938,7 @@ a.home-signup-button {
table.flat-table { table.flat-table {
width: 100%; width: 100%;
margin: 0.5em 0;
} }
.flat-table td { .flat-table td {
padding: 10px; padding: 10px;
@ -1174,9 +1213,9 @@ div.ticket-message-private {
} }
.install-guides li a, .install-guides li a,
.install-guides li a i { .install-guides li a i {
color: #ddd; color: #E1F1FA;
} }
.left-menu a { color: #ccc; } .left-menu a { color: #E1F1FA; }
.homepage h2, .content h2 { .homepage h2, .content h2 {
color: #eee; color: #eee;
} }
@ -1225,6 +1264,16 @@ div.ticket-message-private {
background: #22222b; background: #22222b;
} }
div.ticket-message-user {
background: #222;
}
div.ticket-message-staff {
background: #222238;
}
div.ticket-message-private {
background: #302222;
}
#map svg { #map svg {
fill: #999; fill: #999;
} }
@ -1253,6 +1302,10 @@ div.ticket-message-private {
box-shadow: inset 0 1px 3px #000; box-shadow: inset 0 1px 3px #000;
} }
footer {
background-color: #00234A;
}
} }

@ -3,10 +3,12 @@
{% load static %} {% load static %}
{% block content %} {% block content %}
<div class="content"> <div class="content pure-g">
<div class="pure-u-1">
<h2>{% block pagetitle %}{{ title|default:"Support" }}{% endblock %}</h2> <h2>{% block pagetitle %}{{ title|default:"Support" }}{% endblock %}</h2>
</div>
<div class="flex-page"> <div class="flex-page pure-u-1 pure-u-lg-5-6 pure-u-xl-2-3">
<div class="left-menu"> <div class="left-menu">
<div class="submenu"> <div class="submenu">
<ul> <ul>
@ -36,18 +38,9 @@
{% endif %} {% endif %}
</ul> </ul>
</div> </div>
<div class="submenu">
<p class="menu-title">{% trans 'WireGuard' %}</p>
<ul>
<li><a href="/page/install-wireguard">
<i class="icon icon-wireguard fa-fw" aria-hidden="true"></i>&nbsp;
{% trans 'Setup WireGuard' %}
</a></li>
</ul>
</div>
<div class="submenu"> <div class="submenu">
<p class="menu-title">{% trans 'OpenVPN' %}</p> <p class="menu-title">{% trans 'Setup Guides' %}</p>
<ul> <ul>
<li><a href="/page/install-android"> <li><a href="/page/install-android">
<i class="fa fa-android fa-fw" aria-hidden="true"></i>&nbsp; <i class="fa fa-android fa-fw" aria-hidden="true"></i>&nbsp;
@ -57,19 +50,19 @@
<i class="fa fa-windows fa-fw" aria-hidden="true"></i>&nbsp; <i class="fa fa-windows fa-fw" aria-hidden="true"></i>&nbsp;
{% trans 'Windows' %} {% trans 'Windows' %}
</a></li> </a></li>
<li><a href="/page/install-gnulinux"> <li><a href="/page/install-linux">
<i class="fa fa-linux fa-fw" aria-hidden="true"></i>&nbsp; <i class="fa fa-linux fa-fw" aria-hidden="true"></i>&nbsp;
{% trans 'GNU/Linux' %} {% trans 'Linux' %}
</a></li> </a></li>
<li><a href="/page/install-osx"> <li><a href="/page/install-osx">
<i class="fa fa-apple fa-fw" aria-hidden="true"></i>&nbsp; <i class="fa fa-apple fa-fw" aria-hidden="true"></i>&nbsp;
{% trans 'OS X' %} {% trans 'macOS' %}
</a></li> </a></li>
<li><a href="/page/install-chromeos"> <li><a href="/page/install-chromeos">
<i class="fa fa-chrome fa-fw" aria-hidden="true"></i>&nbsp; <i class="fa fa-chrome fa-fw" aria-hidden="true"></i>&nbsp;
{% trans 'Chrome OS' %} {% trans 'Chrome OS' %}
</a></li> </a></li>
<li><a href="/page/install-openvpn"> <li><a href="/page/install-other">
<i class="fa fa-server fa-fw" aria-hidden="true"></i>&nbsp; <i class="fa fa-server fa-fw" aria-hidden="true"></i>&nbsp;
{% trans 'Other' %} {% trans 'Other' %}
</a></li> </a></li>
@ -86,9 +79,11 @@
</ul> </ul>
</div> </div>
</div> </div>
{% block helpdesk_outer %}
<div class="content-box"> <div class="content-box">
{% block helpdesk_body %}{% endblock %} {% block helpdesk_body %}{% endblock %}
</div> </div>
{% endblock %}
</div> </div>
</div> </div>
{% endblock %} {% endblock %}

@ -0,0 +1,94 @@
{% extends 'base_help.html' %}
{% load i18n %}
{% block pagetitle %}Guides & Support{% endblock %}
{% block helpdesk_outer %}
<div class="flex-page-content">
{% block install_content %}
{% block wireguard_outer %}
<div class="install-section content-box">
<h3>{% trans "With WireGuard" %}</h3>
<p>
<a href="https://www.wireguard.com/">WireGuard<i class="fa fa-external-link external-link"></i></a>
{% blocktrans trimmed %}
is a simple and modern VPN protocol.
{% endblocktrans %}
{% blocktrans trimmed %}
It's generally considered faster and more secure than OpenVPN, but isn't as widely supported.
We recommend using it when available.
{% endblocktrans %}
</p>
<hr />
<div class="install-instructions">
{% block wireguard_setup %}
<ol>
<li>
{% blocktrans trimmed with url="https://www.wireguard.com/install/" %}
Download and install the <a href="{{url}}">WireGuard software from its official website</a>.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
Create a new WireGuard key in
<a href="/account/wireguard">your account</a> and download the configuration file.
{% endblocktrans %}
<br />
{% trans "You need one for each device that you want to associate with your account."%}
</li>
<li>
{% block wireguard_import %}
{% trans "Import the configuration in WireGuard." %}
<ul>
<li>
{% blocktrans trimmed %}
On Android and iOS, open the app and scan the
<a href="/account/wireguard">QR code from your account</a>
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
On Windows, mac OS and Linux, import a configuration file
<a href="/account/wireguard">downloaded from your account</a>
{% endblocktrans %}
</li>
</ul>
{% endblock %}
</li>
<li>
{% block wireguard_activate %}
{% trans "Activate the newly imported configuration in WireGuard."%}<br />
{% trans "You can check your IP address by refreshing this page (or opening it on the device) and looking at the bottom."%}
{% endblock %}
</li>
</ol>
{% endblock %}
</div>
</div>
{% endblock %}
{% block openvpn_outer %}
<div class="install-section content-box">
<h3>{% trans "With OpenVPN" %}</h3>
<p>
<a href="https://www.openvpn.net/">OpenVPN<i class="fa fa-external-link external-link"></i></a>
{% blocktrans trimmed %}
is an older VPN protocol and software, still considered secure and one of the best VPN protocols available.
{% endblocktrans %}
{% blocktrans trimmed %}
It has the advantage over WireGuard of having various implementations for many platforms.
{% endblocktrans %}
</p>
<hr />
<div class="install-instructions">
{% block openvpn_setup %}
{% endblock %}
</div>
</div>
{% endblock %}
{% endblock %}
</div>
{% endblock %}

@ -1,36 +0,0 @@
---
Title: Guides & Support
---
### WireGuard Installation Guide
[WireGuard<i class="fa fa-external-link external-link"></i>](https://www.wireguard.com/)
is the currently recommended VPN technology.
<ul class="install-guides">
<li><a href="/page/install-wireguard"><i class="icon icon-wireguard large"></i> WireGuard</a></li>
</ul>
### OpenVPN Installation Guides
[OpenVPN<i class="fa fa-external-link external-link"></i>](https://openvpn.net/)
is supported for compatibility with many types of devices.
<ul class="install-guides">
<li><a href="/page/install-android"><i class="fa fa-android fa-3x"></i> Android</a></li>
<li><a href="/page/install-windows"><i class="fa fa-windows fa-3x"></i> Windows</a></li>
<li><a href="/page/install-gnulinux"><i class="fa fa-linux fa-3x"></i> GNU/Linux</a></li>
<li><a href="/page/install-osx"><i class="fa fa-apple fa-3x"></i> OS X</a></li>
<li><a href="/page/install-chromeos"><i class="fa fa-chrome fa-3x"></i> Chromebook</a></li>
<li><a href="/page/install-openvpn"><i class="fa fa-server fa-3x"></i> Other</a></li>
</ul>
### Help
- [**Knowledge Base**](/kb/): We already cover many common questions and problems in our knowledge base.
### Contact Us
- [**Tickets**](/tickets/): The most reliable and private way to reach us.
- E-mail: **support at ccrypto.org** if you would like to ask a question without creating an account, or need help with your account.

@ -1,36 +0,0 @@
---
Title: Guides & Support
---
### Installation avec WireGuard
[WireGuard<i class="fa fa-external-link external-link"></i>](https://www.wireguard.com/)
est la technologie VPN que nous recommendons actuellement.
<ul class="install-guides">
<li><a href="/page/install-wireguard"><i class="icon icon-wireguard large"></i> WireGuard</a></li>
</ul>
### Installation avec OpenVPN
[OpenVPN<i class="fa fa-external-link external-link"></i>](https://openvpn.net/)
est aussi supporté pour sa compatibilité avec de nombreuses platformes.
<ul class="install-guides">
<li><a href="/page/install-android"><i class="fa fa-android fa-3x"></i> Android</a></li>
<li><a href="/page/install-windows"><i class="fa fa-windows fa-3x"></i> Windows</a></li>
<li><a href="/page/install-gnulinux"><i class="fa fa-linux fa-3x"></i> GNU/Linux</a></li>
<li><a href="/page/install-osx"><i class="fa fa-apple fa-3x"></i> OS X</a></li>
<li><a href="/page/install-chromeos"><i class="fa fa-chrome fa-3x"></i> Chromebook</a></li>
<li><a href="/page/install-openvpn"><i class="fa fa-server fa-3x"></i> Autre</a></li>
</ul>
### Aide
- [**F.A.Q.**](/kb/): Nous couvrons déjà beaucoup de questions communes dans notre F.A.Q.
### Contactez Nous
- [**Tickets**](/tickets/): Le moyen le plus sûr et fiable de communiquer avec nous.
- E-mail: **support at ccrypto.org** si vous ne voulez pas créer un compte ou avez un problème avec votre compte.

@ -0,0 +1,43 @@
{% extends 'base_help.html' %}
{% load i18n %}
{% block pagetitle %}Guides & Support{% endblock %}
{% block helpdesk_outer %}
<div class="flex-page-content">
<h3>{% trans "Installation Guides for Your Operating System:" %}</h3>
<ul class="install-guides">
<li><a href="/page/install-android"><i class="fa fa-android fa-3x"></i> Android</a></li>
<li><a href="/page/install-windows"><i class="fa fa-windows fa-3x"></i> Windows</a></li>
<li><a href="/page/install-linux"><i class="fa fa-linux fa-3x"></i> Linux</a></li>
<li><a href="/page/install-osx"><i class="fa fa-apple fa-3x"></i> OS X</a></li>
<li><a href="/page/install-chromeos"><i class="fa fa-chrome fa-3x"></i> Chromebook</a></li>
<li><a href="/page/install-openvpn"><i class="fa fa-server fa-3x"></i> Other</a></li>
</ul>
<h3>{% trans "Other useful help pages & contact information:" %}</h3>
<ul>
<li>
{% blocktrans trimmed %}
We already cover many common questions and problems in our <a href="/kb/"><em>Knowledge Base</em></a>.
Take a look if you have any question.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
If you need to contact us, the fastest and most secure way is to use
<a href="/tickets/"><em>Tickets</em></a> for technical or billing issues.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
E-mail <em>support at ccrypto.org</em>
if you would like to talk to us without creating an account, or need help with your account.
{% endblocktrans %}
</li>
</ul>
</div>
{% endblock %}

@ -1,23 +0,0 @@
---
Title: Install on Android
---
1. First, you have to install [Arne Schwabe's OpenVPN for Android][openvpn_android].
It is the most frequently updated and secure OpenVPN client for Android.
2. Download the .ovpn file you need in [your account](/account/config) and save it
somewhere on your Android device.
3. Open the OpenVPN for Android application and import the .ovpn file.
It will create a new profile from the configuration file.
4. *(Optionally)* Edit the imported profile and set your username and password if you do not
want to be asked every time.
5. You can now connect to that profile.
On connection it will show the log while trying to connect.
If it fails to connect, you can use the menu here to send the log by email
to *support at ccrypto.org* or copy it in a support ticket.
[openvpn_android]: https://play.google.com/store/apps/details?id=de.blinkt.openvpn

@ -1,23 +0,0 @@
---
Title: Installation sur Android
---
1. Installez d'abord [OpenVPN pour Android d'Arne Schwabe][openvpn_android].
C'est le client Android le mieux mis à jour et le plus sécurisé.
2. Téléchargez le fichier .ovpn dont vous avez besoin dans [votre compte](/account/config)
et enregistrez-le quelque part.
3. Ouvrez l'application OpenVPN et importez le .ovpn téléchargé. Un nouveau
profile sera crée.
4. *(Facultatif)* Éditez le profile et entrez votre identifiant et mot de passe
pour qu'ils ne soient pas demandés à chaque connexion.
5. Vous pouvez maintenant vous connecter à ce profile.
Pendant la connexion, le log OpenVPN sera affiché. Si il y a une erreur,
vous pouvez envoyer les informations nécessaires à *support at ccrypto.org*
grace au menu ou en copiant le log dans un ticket.
[openvpn_android]: https://play.google.com/store/apps/details?id=de.blinkt.openvpn

@ -0,0 +1,71 @@
{% extends 'pages/_install_base.html' %}
{% load i18n %}
{% block pagetitle %}
{% trans "Install on Android" %}
{% endblock %}
{% block wireguard_setup %}
<ol>
<li>
{% blocktrans trimmed with url="https://play.google.com/store/apps/details?id=com.wireguard.android" %}
Install the <a href="{{url}}">WireGuard app on the Play Store</a>.
{% endblocktrans %}
<br />
{% blocktrans trimmed with url="https://f-droid.org/en/packages/com.wireguard.android/" %}
It is also available on <a href="{{url}}">F-Droid</a> if you prefer.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
Create a new WireGuard key in
<a href="/account/wireguard">your account</a> and display its QR code.
{% endblocktrans %}
<br />
{% trans "You need one for each device that you want to associate with your account."%}
</li>
<li>
{% trans "Import the configuration in WireGuard by opening the app and scanning the QR code."%}
</li>
<li>
{% trans "Activate the newly imported configuration in WireGuard."%}<br />
{% trans "You can check your IP address by refreshing this page (or opening it on the device) and looking at the bottom."%}
</li>
</ol>
{% endblock %}
{% block openvpn_setup %}
<ol>
<li>
{% blocktrans trimmed with url="https://play.google.com/store/apps/details?id=de.blinkt.openvpn" %}
First, install <a href="{{url}}">Arne Schwabe's OpenVPN for Android</a>.
It is the most frequently updated and secure OpenVPN client for Android to our knowledge.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
Download the .ovpn file you need in <a href="/account/config">your account</a> and save it
somewhere on your Android device.
{% endblocktrans %}
</li>
<li>
{% trans "Open the OpenVPN for Android application and import the .ovpn file." %}<br />
{% trans "It will create a new profile from the configuration file." %}
</li>
<li>
<em>{% trans "(Optional) Save your username and password:" %}</em><br />
{% blocktrans trimmed %}
Edit the imported profile and set your username and password if you do not
want to be asked every time.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
You can now connect to that profile.<br />
It will show the log while trying to connect.
If it fails, you can use the menu here to send the log by email
to <em>support at ccrypto.org</em> or copy it in a support ticket.
{% endblocktrans %}
</li>
</ol>
{% endblock %}

@ -1,25 +0,0 @@
---
Title: Install on Chrome OS
---
1. Download the .onc file needed in [your account](/account/config). Select
Chrome OS as the target OS.
2. Go to [chrome://net-internals/](chrome://net-internals/#chromeos), "ChromeOS" section, and import the downloaded file.
It won't display any confirmation; don't worry, it should have imported it anyway.
<img src="/static/pageimg/install_chromeos_1_arrows.png" alt="screenshot" />
3. Open the Chrome OS Settings, click on Private Network (under Ethernet and Wi-Fi),
and select CCrypto VPN.
<img src="/static/pageimg/install_chromeos_2.png" alt="screenshot" />
4. Then click the Connect button, enter your password, and Connect again.
<img src="/static/pageimg/install_chromeos_3.png" alt="screenshot" />
5. Wait a few seconds and it should be connected.
<img src="/static/pageimg/install_chromeos_4.png" alt="screenshot" />

@ -0,0 +1,50 @@
{% extends 'pages/_install_base.html' %}
{% load i18n %}
{% load static %}
{% block pagetitle %}
{% trans "Install on Chrome OS" %}
{% endblock %}
{% block wireguard_outer %}
{% endblock %}
{% block openvpn_outer %}
<div class="install-section content-box">
<h3>{% trans "With OpenVPN" %}</h3>
<div class="install-instructions">
<ol>
<li>
{% blocktrans trimmed %}
Download the .onc file needed in <a href="/account/config">your account</a>.
Select Chrome OS as the target OS.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed with url="chrome://net-internals/#chromeos" %}
Go to <a href="{{url}}">{{url}}</a>, "ChromeOS" section, and import the downloaded file.
It won't display any confirmation; don't worry, it should have imported it anyway.
{% endblocktrans %}
<img src="{% static "pageimg/install_chromeos_1_arrows.png" %}" alt="screenshot" />
</li>
<li>
{% blocktrans trimmed %}
Open the Chrome OS Settings, click on Private Network (under Ethernet and Wi-Fi),
and select CCrypto VPN.
{% endblocktrans %}
<img src="{% static "pageimg/install_chromeos_2.png" %}" alt="screenshot" />
</li>
<li>
{% blocktrans trimmed %}
Then click the Connect button, enter your password, and Connect again.
{% endblocktrans %}
<img src="{% static "pageimg/install_chromeos_3.png" %}" alt="screenshot" />
</li>
<li>
{% trans "Wait a few seconds and it should be connected." %}
<img src="{% static "pageimg/install_chromeos_4.png" %}" alt="screenshot" />
</li>
</ol>
</div>
</div>
{% endblock %}

@ -1,104 +0,0 @@
---
Title: Install on GNU/Linux
---
### With NetworkManager
1. Download and install OpenVPN and the NetworkManager plugin with your package manager.
- *Debian*: `sudo apt-get install openvpn resolvconf network-manager-openvpn network-manager-openvpn-gnome`
- *Fedora*: `sudo yum install openvpn networkmanager-openvpn`
- *Arch Linux*: `sudo pacman -S openvpn networkmanager-openvpn`
2. You will also need our CA certificate, available here: <https://vpn.ccrypto.org/ca.crt>
You can right click on that link and save the file or download it differently.
It will be required to connect, so make sure to not delete it later.
3. Create a new connection and choose the type *OpenVPN*.
4. You will need to fill in the following VPN configuration:
- **Tab VPN**
- **Gateway**: `gw.random.204vpn.net` for a random server, or pick one in the [server list](/status).
- **Type**: *Password*
- **User name** and **Password**: The same as on this site.
- **CA certificate**: The ca.crt file downloader in the previous step.
- **Tab VPN, click on Advanced, then the first General tab**
- **Use custom gateway port**: It should be *checked* and set to *1196*.
- **Use a TCP connection**: It should be *unchecked* to use the fastest UDP mode.
If you have issues connecting, you can try setting the port to *443* and checking this option.
- **Randomize remote hosts**: It should be *checked*.
- **IPv6 tun link**: It should be checked unless you get IPv6-related issues.
3. Save the new connection and connect to it.
### With systemd (Arch, Fedora 16 or later, Debian 8 or later, ...)
1. Download and install OpenVPN with your package manager.
- Debian: `sudo apt-get install openvpn`
- Fedora: `sudo yum install openvpn`
- Arch Linux: `sudo pacman -S openvpn`
2. Download the .ovpn file you need in [your account](/account/config) and put
it in `/etc/openvpn/` .
ie: `/etc/openvpn/ccrypto.conf`
3. Start the OpenVPN service:
sudo systemctl start openvpn@ccrypto
4. *(Optional)* To make OpenVPN start at boot,
create a text file anywhere and write your username and
password inside, on two lines.
Then, add at the end of your ccrypto.conf file:
auth-user-pass /path/to/the/file.txt
And enable the systemd service :
systemctl enable openvpn@ccrypto
For additional security, you can make sure only root is be able to access this file:
sudo chown root:root /path/to/the/file.txt
sudo chmod 600 /path/to/the/file.txt
Without systemd (Debian before 8.0, ...)
---------------
1. Download and install OpenVPN with your package manager.
- Debian: `sudo apt-get install openvpn resolvconf`
- Fedora: `sudo yum install openvpn`
2. Download the .ovpn file you need in [your account](/account/config) and put
it in `/etc/openvpn/` .
ie: `/etc/openvpn/ccrypto.conf`
3. Start the OpenVPN service:
sudo service openvpn start ccrypto
4. *(Optional)* To make OpenVPN start at boot,
create a text file anywhere and write your username and
password inside, on two lines.
Then, add at the end of your ccrypto.conf file:
auth-user-pass /path/to/the/file.txt
And add the configuration file name to the AUTOSTART list in `/etc/default/openvpn` (you can add it at the end):
AUTOSTART="ccrypto"
For additional security, you can make sure only root is be able to access this file:
sudo chown root:root /path/to/the/file.txt
sudo chmod 600 /path/to/the/file.txt

@ -1,105 +0,0 @@
---
Title: Installation sous GNU/Linux
---
### Avec NetworkManager
1. Téléchargez et installez OpenVPN et le plugin NM avec votre gestionnaire de paquets :
- *Debian*: `sudo apt-get install openvpn resolvconf network-manager-openvpn network-manager-openvpn-gnome`
- *Fedora*: `sudo yum install openvpn networkmanager-openvpn`
- *Arch Linux*: `sudo pacman -S openvpn networkmanager-openvpn`
2. Vous aurez aussi besoin de notre certificat: <https://vpn.ccrypto.org/ca.crt>
Vous pouvez le télécharger avec un clic droit ou une autre méthode.
It sera nécessaire pour se connecter, placez-le en lieu sûr.
3. Créez une nouvelle connection de type *OpenVPN*.
4. Copiez la configuration du VPN:
- **Onglet VPN**
- **Passerelle**: `gw.random.204vpn.net` pour un serveur aléatoire, ou choisissez un pays dans [la liste](/status).
- **Type**: *Mot de passe*
- **Nom d'utilisateur** and **Mot de passe**: Les même que sur ce site.
- **CA certificate**: Le fichier ca.crt téléchargé dans l'étape précédente.
- **Onglet VPN, dans Avancé/Advanced, puis l'onglet Général**
- **Uiliser un port de passerelle personnalisé**: *Coché* et sur *1196*.
- **Utiliser une connexion TCP**: *Décoché* pour utiliser le mode UDP plus rapide.
Si la connexion ne passe pas, vous pouvez essayer en TCP sur le port *443*.
- **Randomiser les hôtes distants**: *Coché*.
- **IPv6 tun link**: *Coché* sauf si vous constatez des problèmes liés à l'IPv6.
3. Enregistrez la connexion et connectez-vous.
### Avec systemd (Arch, Fedora 16 ou plus, Debian 8 ou plus, ...)
1. Téléchargez et installez OpenVPN avec votre gestionnaire de paquets :
- Debian: `sudo apt-get install openvpn`
- Fedora: `sudo yum install openvpn`
- Arch Linux: `sudo pacman -S openvpn`
2. Téléchargez la configuration (.ovpn) dont vous avez besoin dans
[votre compte](/account/config) et placez la dans `/etc/openvpn/` .
Renommez le pour avoir un .conf.
ie: `/etc/openvpn/ccrypto.conf`
3. Démarrez le service OpenVPN :
sudo systemctl start openvpn@ccrypto
4. *(Facultatif)* Pour qu'OpenVPN puisse se connecter au démarrage,
créez un fichier texte quelque part avec votre identifiant et votre
mot de passe, sur deux lignes. Ajoutez ensuite cette ligne à la fin de
votre fichier .conf :
auth-user-pass /path/to/the/file.txt
Et activez le service systemd :
systemctl enable openvpn@ccrypto
Pour plus de sécurité, vous pouvez restreindre l'accès à ce fichier :
sudo chown root:root /path/to/the/file.txt
sudo chmod 600 /path/to/the/file.txt
Sans systemd (Debian avant 8.0, ...)
---------------
1. Téléchargez et installez OpenVPN avec votre gestionnaire de paquets :
- Debian: `sudo apt-get install openvpn resolvconf`
- Fedora: `sudo yum install openvpn`
2. Téléchargez la configuration (.ovpn) dont vous avez besoin dans
[votre compte](/account/config) et placez la dans `/etc/openvpn/` .
Renommez le pour avoir un .conf.
ie: `/etc/openvpn/ccrypto.conf`
3. Démarrez le service OpenVPN :
sudo service openvpn start ccrypto
4. *(Facultatif)* Pour qu'OpenVPN puisse se connecter au démarrage,
créez un fichier texte quelque part avec votre identifiant et votre
mot de passe, sur deux lignes. Ajoutez ensuite cette ligne à la fin de
votre fichier .conf :
auth-user-pass /path/to/the/file.txt
Ajoutez le nom du fichier de configuration à la liste AUTOSTART dans `/etc/default/openvpn` (vous pouvez l'ajouter à la fin):
AUTOSTART="ccrypto"
Pour plus de sécurité, vous pouvez restreindre l'accès à ce fichier :
sudo chown root:root /path/to/the/file.txt
sudo chmod 600 /path/to/the/file.txt

@ -0,0 +1,189 @@
{% extends 'pages/_install_base.html' %}
{% load i18n %}
{% load dltags %}
{% block pagetitle %}
{% trans "Install on Linux" %}
{% endblock %}
{% block wireguard_import %}
{% blocktrans trimmed %}
Place the configuration file in <code>/etc/wireguard</code>.
{% endblocktrans %}
<br />
{% trans "Then, start it with the following command:" %}
<code class="codeblock">
sudo wg-quick ccvpn-fr up
</code>
{% endblock %}
{% block wireguard_activate %}
{% trans "You can check your IP address by refreshing this page (or opening it on the device) and looking at the bottom."%}
{% endblock %}
{% block openvpn_outer %}
<div class="install-section content-box">
<h3>{% trans "With OpenVPN and NetworkManager" %}</h3>
<p>
<a href="https://www.openvpn.net/">OpenVPN<i class="fa fa-external-link external-link"></i></a>
{% blocktrans trimmed %}
is an older VPN protocol and software, still considered secure and one of the best VPN protocols available.
{% endblocktrans %}
{% blocktrans trimmed %}
This guide focuses on its integration with NetworkManager.
If you are not using NetworkManager, skip to the next guide.
{% endblocktrans %}
</p>
<hr />
<div class="install-instructions">
<ol>
<li>
{% trans "Install the required packages:" %}
<ul>
<li>
<em>Debian:</em>
<code>sudo apt-get install openvpn resolvconf network-manager-openvpn network-manager-openvpn-gnome</code>
</li>
<li>
<em>Fedora:</em>
<code>sudo yum install openvpn networkmanager-openvpn</code>
</li>
<li>
<em>Arch:</em>
<code>sudo pacman -S openvpn networkmanager-openvpn</code>
</li>
</ul>
</li>
<li>
{% trans "You will also need our CA certificate, available here:" %} <a href="https://vpn.ccrypto.org/ca.crt">https://vpn.ccrypto.org/ca.crt</a>
<br />
{% blocktrans trimmed %}
You can right click on that link and save the file, it will be required to connect.
{% endblocktrans %}
</li>
<li>
{% trans "Create a new connection and choose the type <em>OpenVPN</em>." %}
</li>
<li>
{% trans "You will need to fill in the following VPN configuration:" %}
<ul>
<li>
<strong>{% trans "Tab VPN" %}</strong>
<ul>
<li><strong>{% trans "Gateway" %}</strong>:
{% blocktrans trimmed with url="/status" gw="gw.random.204vpn.net" %}
Pick one in the <a href="{{url}}">server list</a>,
or <code>{{gw}}</code> for a random server.
{% endblocktrans %}
</li>
<li><strong>{% trans "Type" %}</strong>: <em>{% trans "Password" %}</em></li>
<li><strong>{% trans "User name and Password" %}</strong>: {% trans "The same as on this site." %}</li>
<li><strong>{% trans "CA certificate" %}</strong>: {% trans "The ca.crt file downloaded in the previous step." %}</li>
</ul>
</li>
<li>
<strong>{% trans "Tab VPN, click on Advanced, then the first General tab" %}</strong>
<ul>
<li><strong>{% trans "Use custom gateway port" %}</strong>: {% trans "It should be <em>checked</em> and set to <em>1196</em>." %}</li>
<li><strong>{% trans "Use a TCP connection" %}</strong>: {% trans "It should be <em>unchecked</em> to use the fastest UDP mode." %}
{% trans "If you have issues connecting, you can try setting the port to <em>443</em> and checking this option." %}</li>
<li><strong>{% trans "Randomize remote hosts" %}</strong>: {% trans "It should be <em>checked</em>." %}</li>
<li><strong>{% trans "IPv6 tun link" %}</strong>: {% trans "It should be checked unless you get IPv6-related issues." %}</li>
</ul>
</li>
</ul>
</li>
<li>
{% trans "Save the new connection and connect to it." %}
</li>
</ol>
</div>
</div>
<div class="install-section content-box">
<h3>{% trans "With OpenVPN and systemd" %}</h3>
<div class="install-instructions">
<ol>
<li>
{% trans "Install the required packages:" %}
<ul>
<li>
<em>Debian:</em>
<code>sudo apt-get install openvpn resolvconf</code>
</li>
<li>
<em>Fedora:</em>
<code>sudo yum install openvpn</code>
</li>
<li>
<em>Arch:</em>
<code>sudo pacman -S openvpn openresolv</code>
</li>
</ul>
</li>
<li>
{% trans "You will also need our CA certificate, available here:" %} <a href="https://vpn.ccrypto.org/ca.crt">https://vpn.ccrypto.org/ca.crt</a>
<br />
{% blocktrans trimmed %}
You can right click on that link and save the file or wget it later, it will be required to connect.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
In <a href="/account/config">your account</a>, download a .ovpn configuration file,
and copy it into <code>/etc/openvpn</code> with a .conf extension.<br />
Keep the name simple, as it will be used in a systemd service name.
{% endblocktrans %}
<br />
{% blocktrans trimmed %}
If you downloaded multiple config files as an archive, extract it so that
the individual .ovpn files are directly in the <code>/etc/openvpn</code> folder,
and rename them to .conf.
{% endblocktrans %}
</li>
<li>
{% trans "Start the OpenVPN services:" %}
<code class="codeblock">
sudo systemctl start openvpn@ccrypto-fr.service
</code>
</li>
<li>
<em>{% trans "(Optional) Save your username and password:" %}</em><br />
<ul>
<li>
{% blocktrans trimmed %}
Create a text file in <code>/etc/openvpn</code> containing your username and password on two lines as follows:
{% endblocktrans %}
<code class="codeblock">Alice<br />p4ssw0rd</code>
</li>
<li>
{% blocktrans trimmed %}
For additional security, only allow root to access this file:
{% endblocktrans %}
<code class="codeblock">
sudo chown root:root /path/to/the/file.txt
sudo chmod 600 /path/to/the/file.txt
</code>
</li>
<li>
{% blocktrans trimmed %}
Then, open the .conf file with a text editor (nano, vim, gedit, ...)
and add this line at the end of the file:
{% endblocktrans %}
<code class="codeblock">auth-user-pass /path/to/the/file.txt</code>
</li>
<li>
{% trans "Reconnect and it should not ask for your password." %}
</li>
<li>
{% trans "To start it on boot, use this:" %}
<code class="codeblock">
sudo systemctl enable openvpn@ccrypto-fr.service
</code>
</li>
</ul>
</li>
</ol>
</div>
</div>
{% endblock %}

@ -1,13 +0,0 @@
---
Title: Install on Mac OS X
---
1. Download the .ovpn file you need in [your account](/account/config).
2. Download and install [TunnelBlick](https://tunnelblick.net/).
3. Import the provided .ovpn OpenVPN configuration in TunnelBlick.
4. The VPN is now ready to use within TunnelBlick.

@ -1,13 +0,0 @@
---
Title: Installation sous Mac OS X
---
1. Télécharger la configuration (.ovpn) dont vous avez besoin dans [votre compte](/account/config).
2. Téléchargez et installez [TunnelBlick](https://tunnelblick.net/).
3. Importez le fichier .ovpn dans TunnelBlick.
4. Vous pouvez utiliser le VPN avec TunnelBlick.

@ -0,0 +1,31 @@
{% extends 'pages/_install_base.html' %}
{% load i18n %}
{% load dltags %}
{% block pagetitle %}
{% trans "Install on macOS" %}
{% endblock %}
{% block wireguard_import %}
{% trans "Import the configuration in WireGuard."%}
{% endblock %}
{% block openvpn_setup %}
<ol>
<li>
{% blocktrans trimmed with url="https://tunnelblick.net/" %}
Download and install <a href="{{url}}">TunnelBlick</a>.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
In <a href="/account/config">your account</a>, download a .ovpn configuration file,
and import it in TunnelBlick.
{% endblocktrans %}
</li>
<li>
{% trans "Connect to the newly added connection." %}
</li>
</ol>
{% endblock %}

@ -1,12 +1,17 @@
--- {% extends 'pages/_install_base.html' %}
Title: Configure OpenVPN {% load i18n %}
--- {% load dltags %}
{% block pagetitle %}
{% trans "Install on Other Platforms" %}
{% endblock %}
{% block openvpn_setup %}
Some devices will let you upload and import a VPN configuration; the "Other / GNU/Linux" configuration option is made to be compatible. Some devices will let you upload and import a VPN configuration; the "Other / GNU/Linux" configuration option is made to be compatible.
For most other devices and client applications, including most routers supporting OpenVPN, you will need to fill in a few parameters as described below: For most other devices and client applications, including most routers supporting OpenVPN, you will need to fill in a few parameters as described below:
<table class="admin-list"> <table class="flat-table">
<thead><tr><td>Option</td><td>Value</td></tr></thead> <thead><tr><td>Option</td><td>Value</td></tr></thead>
<tr> <tr>
<td>CA Certificate</td> <td>CA Certificate</td>
@ -45,4 +50,4 @@ For most other devices and client applications, including most routers supportin
<td><code>10.99.0.20</code></td> <td><code>10.99.0.20</code></td>
</tr> </tr>
</table> </table>
{% endblock %}

@ -1,64 +0,0 @@
---
Title: Install on Windows
---
{% load dltags %}
### With CCVPN GUI (recommended, simple)
CCVPN GUI is made for CCrypto VPN and contains everything it needs.
{% download_button "ccvpngui" "windows" %}
The installer will ask if you want to create a desktop icon.
Once installed, you will only have to right click the icon in the notification
area and select "Connect".
A window will open to show you the progression, you can close it at any time and
the VPN will stay connected.
It's open-source and based on [LVPNGUI](https://github.com/PacketImpact/lvpngui/).
---
### With OpenVPN GUI (advanced)
1. Download OpenVPN for Windows on
[OpenVPN.net](http://openvpn.net/index.php/open-source/downloads.html)
(you need the Windows Installer) and install OpenVPN.
2. In [your account](/account/config), download the config file (.ovpn) you want to use,
and copy it to `C:\Program Files\OpenVPN\config\`.
If you downloaded multiple config files as an archive, extract it in that folder.
3. Start `OpenVPN GUI` *as Administrator*. You can find it on your desktop or in the start menu.
Once it's started, you should see it in the system tray. Right click it and select Connect.
4. It should now open a OpenVPN log window showing its progress.
If an error occured, please see the [self-diagnosis](/page/self-diagnosis) page.
If it doesn't solve your problem or you have another question, contact
our [support](/tickets/)
5. If everything worked, the OpenVPN icon should turn green.
Your are now connected and can enjoy your secure connection.
#### Save username and password
You can make OpenVPN remember your username and password, so you don't need
to type them everytime you want to use the VPN.
This can be done by creating a text file named "ccrypto_creds.txt" containing
your username on the first line and your password on the second
(see example below).
Move it to `C:\Program Files\OpenVPN\config\`, next to the .ovpn file you
copied there before.
It should look like this:
JackSparrow
s0mep4ssw0rd
Then, open the .ovpn file with a text editor (Notepad, Notepad++, ...)
and add this line at the end of the file:
auth-user-pass ccrypto_creds.txt
Now, if you restart OpenVPN, it should not ask you for your password anymore.

@ -1,65 +0,0 @@
---
Title: Installation sous Windows
---
{% load dltags %}
### Avec CCVPN GUI (recommandé, simple)
CCVPN GUI est fait pour CCrypto VPN et contient tout ce qu'il faut.
{% download_button "ccvpngui" "windows" %}
À l'installation, il vous sera proposé d'installer une icône sur le bureau.
Vous aurez ensuite à faire un clic-droit sur l'icône dans la zone de notification,
puis "Connecter".
Une fenêtre s'affichera pour vous informer de la progression, vous pouvez la fermer
à n'importe quel moment et le VPN restera connecté.
C'est open-source et basé sur [LVPNGUI](https://github.com/PacketImpact/lvpngui/).
---
### Avec OpenVPN GUI (avancé)
1. Téléchargez le Windows Installer d'OpenVPN sur
[OpenVPN.net](http://openvpn.net/index.php/open-source/downloads.html)
et installez OpenVPN.
2. Dans [votre compte](/account/config), téléchargez le fichier de configuration (.ovpn)
et copiez le dans `C:\Program Files\OpenVPN\config\`.
Si vous avez téléchargé plusieurs fichiers dans une archive, extrayez l'archive dans
`C:\Program Files\OpenVPN\config\`
3. Démarrez `OpenVPN GUI` *en tant qu'Administrateur*. Vous pouvez le trouver sur le bureau ou
dans le menu Démarrer.
Une fois démarré, vous devriez le voir dans la zone de notification.
Faites un clic droit dessus, et choisissez `Connect`.
4. Une fenêtre de log OpenVPN devrait s'ouvrir et montrer la progression.
Si il y a une erreur, elle y sera affichée et vous pourrez lire
[la page d'auto-diagnostic](/page/self-diagnosis).
Si votre problème n'est pas résolu, [contactez le support](/tickets/).
5. Si la connexion s'est bien passée, l'icone OpenVPN devrait devenir verte.
Vous êtes alors connecté et pouvez profiter de votre connexion sécurisée.
#### Enregistrer les identifiants
Vous pouvez faire qu'OpenVPN enregistre votre nom d'utilisateur et votre mot de
passe, pour ne pas avoir à l'entrer à chaque connexion.
Créez un fichier texte "ccrypto_creds.txt" contenant votre nom sur la
première ligne, et votre mot de passe sur la deuxième, comme ceci:
JackSparrow
s0mep4ssw0rd
Déplacez-le ensuite dans `C:\Program Files\OpenVPN\config\`, avec le fichier
ccrypto.ovpn que vous avez téléchargé plus tôt.
Ouvrez ccrypto.ovpn avec un éditeur de texte (Bloc-notes, Notepad++, ...)
et ajouter une ligne à la fin:
auth-user-pass ccrypto_creds.txt
Pour finir, redémarrez OpenVPN GUI et connectez vous : il ne devrait plus vous
demander votre mot de passe.

@ -0,0 +1,143 @@
{% extends 'pages/_install_base.html' %}
{% load i18n %}
{% load dltags %}
{% block pagetitle %}
{% trans "Install on Windows" %}
{% endblock %}
{% block wireguard_import %}
{% trans "Import the configuration in WireGuard."%}
{% endblock %}
{% block openvpn_outer %}
<div class="install-section content-box">
<h3>{% trans "With CCVPN GUI" %}</h3>
<p>
{% blocktrans trimmed %}
CCVPN GUI is a VPN client specifically made for our VPN on Windows.
It should provide the simplest and smoothest interface to connect over OpenVPN.
{% endblocktrans %}
{% blocktrans trimmed with url="https://github.com/PacketImpact/lvpngui/" %}
It's also <a href="{{url}}">open-source</a>.
{% endblocktrans %}
</p>
<hr />
<div class="install-instructions">
<ol>
<li>
{% trans "Download and run the CCVPN GUI installer:" %}<br />
{% download_button "ccvpngui" "windows" %}
<br />
<br />
{% blocktrans trimmed %}
Please ignore Windows's warnings and click "Run anyway" -
they are due to the file not having been downloaded frequently enough to be considered safe.
{% endblocktrans %}
<br />
</li>
<li>
{% blocktrans trimmed %}
Once installed and started, right click the icon in the notification
area and select "Connect".
{% endblocktrans %}
{% blocktrans trimmed %}
A window will open to show you the progression, you can close it at any time and
the VPN will stay connected.
{% endblocktrans %}
</li>
<li>
<em>{% trans "(Optional)" %}</em>
{% blocktrans trimmed %}
You can set it to start and connect automatically on boot in the <em>Settings</em>.
{% endblocktrans %}
<br />
{% blocktrans trimmed %}
If you have connection issues and you think it might be blocked, try <em>TCP mode</em> in the settings.
{% endblocktrans %}
</li>
</ol>
</div>
</div>
<div class="install-section content-box">
<h3>{% trans "With OpenVPN" %}</h3>
<p>
<a href="https://www.openvpn.net/">OpenVPN<i class="fa fa-external-link external-link"></i></a>
{% blocktrans trimmed %}
is an older VPN protocol and software, still considered secure and one of the best VPN protocols available.
{% endblocktrans %}
<br />
{% blocktrans trimmed %}
This section is about the reference implementation, OpenVPN GUI.
{% endblocktrans %}
</p>
<hr />
<div class="install-instructions">
<ol>
<li>
{% blocktrans trimmed with url="http://openvpn.net/index.php/open-source/downloads.html" %}
Download the Windows Installer for OpenVPN on <a href="{{url}}">OpenVPN.net</a> and install it.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
In <a href="/account/config">your account</a>, download a .ovpn configuration file,
and copy it into <code>C:\Program Files\OpenVPN\config\</code>.
{% endblocktrans %}
<br />
{% blocktrans trimmed %}
If you downloaded multiple config files as an archive, extract it in that folder so that
the individual .ovpn files are directly in the config folder.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
Start OpenVPN GUI <em>as Administrator</em>. You can find it on your desktop or in the start menu.
{% endblocktrans %}
<br />
{% blocktrans trimmed %}
Once it's started, you should see it in the system tray. Right click it and select Connect.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
It should now open a OpenVPN log window showing its progress.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
If everything worked, the OpenVPN icon should turn green.<br />
Your are now connected and can enjoy your secure connection.
{% endblocktrans %}
</li>
<li>
<em>{% trans "(Optional) Save your username and password:" %}</em><br />
<ul>
<li>
{% blocktrans trimmed %}
Create a text file "ccrypto_creds.txt" containing your username and password on two lines as follows:
{% endblocktrans %}
<code class="codeblock">Alice<br />p4ssw0rd</code>
</li>
<li>
{% blocktrans trimmed %}
Move the file to <code>C:\Program Files\OpenVPN\config\</code> along with the .ovpn file.
{% endblocktrans %}
</li>
<li>
{% blocktrans trimmed %}
Then, open the .ovpn file with a text editor (Notepad, Notepad++, ...)
and add this line at the end of the file:
{% endblocktrans %}
<code class="codeblock">auth-user-pass ccrypto_creds.txt</code>
</li>
<li>
{% trans "Reconnect and it should not ask for your password." %}
</li>
</ul>
</li>
</ol>
</div>
</div>
{% endblock %}

@ -1,18 +0,0 @@
---
Title: Install WireGuard
---
1. Download and install the WireGuard software,
with instructions for each device and operating systems on its official website:
[*Installation - Wireguard*](https://www.wireguard.com/install/).
2. Create a new WireGuard key in [your account](/account/wireguard).
You need one for each device that you want to associate with your account.
3. Import the configuration in WireGuard.
- On Android and iOS, open the app and scan the [QR code from your account](/account/wireguard)
- On Windows, mac OS and Linux, import a configuration file [downloaded from your account](/account/wireguard).
4. Activate the newly imported configuration in WireGuard.
You can check your IP address by refreshing this page (or opening it on the device) and looking at the bottom.

@ -1,20 +0,0 @@
---
Title: Installation de WireGuard
---
1. Téléchargez et installez le logiciel WireGuard.
Des instructions spécifique pour chaque plateforme supportée sont disponibles
sur son site officiel:
[*Installation - Wireguard*](https://www.wireguard.com/install/).
2. Créez une nouvelle clé WireGuard dans [votre compte](/account/wireguard).
Vous aurez besoin d'une clé par appareil à associer à votre compte.
3. Importez la configuration dans WireGuard.
- Sur Android et iOS, ouvrez l'app et scannez le [code QR disponible dans votre compte](/account/wireguard)
- Sur Windows, mac OS, et Linux, importez le fichier de configuration [à télécharger dans votre compte](/account/wireguard).
4. Activez la configuration dans WireGuard.
Vous pouvez vérifier votre adresse IP en rafraichissant cette page (ou en l'ouvrant sur l'appareil à connecter)
en bas à droite.
Loading…
Cancel
Save