Instalar
⚠ Rama experimental, no oficial. El Oasis oficial es https://github.com/epsylon/oasis · Volver a la portada
Igual que el Oasis oficial, porque es el mismo árbol con un módulo más.
git clone https://gitea.laenre.net/hacklab/OASIS_LINUX.git
cd OASIS_LINUX/src/server && npm install
cd ../.. && ./oasis.sh
Abre http://localhost:3000.
Al arrancar verás en el terminal el resumen de siempre y, al final,
Modules loaded: [ 999 ]. Eso significa que el backend está en pie.
Activar Karvan
Viene activado. Si no lo ves en el menú lateral, míralo en /modules: aparece entre
Jobs y L.A.R.P.
Cómo encaja todo
Oasis levanta un servidor en tu propia máquina. El navegador es solo la ventana: las páginas se generan localmente y no pasan por ningún sitio ajeno. Lo único que sale a la red es la replicación, por el puerto 8008.
Varias identidades en el mismo equipo
Esta rama admite más de una cuenta. La variable OASIS_ACCOUNT decide dónde vive
todo: el secret, la base de datos y los blobs.
./oasis.sh # la de siempre, en ~/.ssb
OASIS_ACCOUNT=pruebas ./oasis.sh # otra identidad, en ~/.pruebas
El nombre se valida (letras, números, guion y guion bajo, hasta 32 caracteres) porque acaba formando rutas de fichero y hay operaciones destructivas —el modo pánico borra el directorio de la cuenta— que no deben poder apuntar fuera de sitio.
Sirve para probar esta rama sin tocar tu identidad real, que es lo recomendable:
OASIS_ACCOUNT=pruebas ./oasis.sh gui --host=127.0.0.1 --port=3010
El selector de los ajustes
En Settings → Identities están todas las identidades que hay en el disco, con el
principio de su @id. La que está en uso lo dice en verde; las demás traen un botón.
Elegir una solo anota cuál será la próxima: el cambio ocurre al reiniciar Oasis. Se hace así a propósito —media aplicación guarda la referencia al servidor SSB en cuanto se carga, y cambiarla con el proceso vivo dejaría módulos hablando con la identidad anterior sin que se note—.
La variable OASIS_ACCOUNT sigue mandando sobre lo que diga el selector.
El aviso rojo
Si dos identidades muestran "Comparte clave con otra identidad", sus carpetas
tienen el mismo secret copiado, lo típico tras una copia manual.
No publiques desde las dos. Un registro de SSB es una cadena firmada y numerada: si dos sitios publican el número 500 con contenidos distintos, la red ve una bifurcación, deja de replicar el feed y eso no se arregla. Se pierde la identidad.
Tener la copia no hace daño. Publicar desde las dos, sí.
Si los iconos se ven como cuadros
Oasis usa caracteres Unicode poco comunes para los iconos del menú. Si te salen como □, tu sistema no tiene una fuente que los cubra:
sudo apt install fonts-noto-core # Debian, Ubuntu y derivadas
No es un fallo de Oasis y no afecta a nada más que a cómo se ve.
Configurar un TURN
Solo si quieres llamadas fuera de tu red local. En src/configs/oasis-config.json:
"rtc": {
"stun": ["stun:tu.pub:3478"],
"turn": { "urls": ["turn:tu.pub:3478"], "secret": "<static-auth-secret>", "ttlSec": 3600 },
"relayOnly": false
}
De fábrica está vacío: sin servidores de terceros. Ver Llamadas para el porqué y para cómo endurecer coturn.
Si vienes del Oasis oficial
Tu identidad y tus datos están en ~/.ssb y esta rama los usa igual. Aun así, haz
copia de seguridad antes de probar: es una rama experimental.
⚠ No ejecutes esta rama y el Oasis oficial a la vez con la misma identidad. Publicar desde dos sitios con el mismo
secretparte tu registro y lo deja inservible para siempre. No es recuperable.