|
||
---|---|---|
how-to | ||
templates | ||
.gitignore | ||
LICENSE | ||
README.md |
README.md
⚡ This project is a personal initiative, without any official support by Nextcloud GmbH |
---|
Introduction
nc-env is a tool that enables you to provision isolated Nextcloud test environments in your machine. It is built on vagrant and LXD.
Features
You can leverage this tool to:
- Quickly setup and run an isolated Nextcloud instance in your machine.
- Try features or troubleshoot issues without any manual installation and minimal configuration.
- Learn and explore the integration of Nextcloud with common enterprise systems, such as LDAP, ElasticSearch, Single Sign-On or an Office Editing Service.
Available Templates
nc-env is based on templates. A template is a set of instructions and artifacts sufficient to have a service up and running in a container.
⚡ The templates in this repository are designed and developed for testing and development environments, not for production |
---|
The following table summarizes the list of available templates:
Template | Description | Maintained |
---|---|---|
template00-clean-server |
Clean server | YES |
template01-nextcloud-standalone |
Nextcloud standalone server | YES |
template02-collabora-online |
Collabora Online server - CODE or Enterprise | YES |
template03-keycloak |
Keycloak standalone server | YES |
template04-ldap |
OpenLDAP server + phpLDAPadmin | YES |
template05-elasticsearch |
ElasticSearch server | YES |
template06-nextcloud-db-standalone |
Database node (to be used in a cluster) | YES |
template07-glusterfs-server |
GlusterFS node (to be used in a cluster) | YES |
template08-haproxy-server |
HAproxy (to be used in a cluster) | YES |
template09-web-server-node |
Web Server Node (to be used in a cluster) | YES |
template10-redis-server |
Redis server(to be used in a cluster) | YES |
template11-minio-storage-server |
MinIO Storage Server | YES |
template13-talk-hpb |
Talk High Performance Backend | YES |
template14-self-hosted-appstore |
Nextcloud Self-Hosted Appstore | NO |
template16-zabbix-server |
Zabbix Monitoring Server | YES |
template17-mail-server |
Mox Mail Server | YES |
Setup
This section aims at giving an high-level procedure to setup your environment.
Please head to the how-to
folder to find step-by-step guides for the most common Linux Desktop distributions (Fedora, Ubuntu, Debian).
- Install and configure LXD
- Configure the host to resolve container hostnames
- Install and configure vagrant
- Install LXD plugin vagrant-lxd
- Install mkcert
- Get the latest release of nc-env
- Start provisioning
A Virtual Machine is also available for those that want to have a fully isolated environment, instructions are available here.
Resources
- Article: nc-env: A tool to deploy Nextcloud Environments in your laptop.
- Video: This workshop, recorded at esLibre 2022, is focused on how to build a Nextcloud cluster using nc-env. In Spanish.