Archived

This repository has been archived on 2024-06-24. You can view files and clone it, but cannot push or open issues or pull requests.

Miroslav Šedivý d1f1be4e86 add to docs faq: Run neko without docker on host #314 .

2024-03-28 23:54:26 +01:00

2.5 KiB

Raw Permalink Blame History

Frequently Asked Questions

How to enable debug mode?

To see verbose information from n.eko server, you can enable debug mode using NEKO_DEBUG.

version: "3.4"
services:
  neko:
    image: "m1k1o/neko:firefox"
    restart: "unless-stopped"
    shm_size: "2gb"
    ports:
      - "8080:8080"
      - "52000-52100:52000-52100/udp"
    environment:
     NEKO_SCREEN: 1920x1080@30
     NEKO_PASSWORD: neko
     NEKO_PASSWORD_ADMIN: admin
     NEKO_EPR: 52000-52100
     NEKO_ICELITE: 1
+     NEKO_DEBUG: 1

Ensure, that you have enabled debug mode in javascript console too, in order to see verbose information from client.

Chinese input method is not working

There exists an extension for Chrome that allows you to use Chinese input method. You can install it from here. Alternatively, you can use Google Input Tools from here.

Only black screen is displayed but remote cursor is moving for Chromium-based browsers (Chrome, Edge, etc.)

Check if you did not forget to add cap_add to your docker-compose file.

    cap_add:
      - SYS_ADMIN

## How can I embed the Neko desktop into web page without login prompt coming up for viewers?

You can use the following URL to embed the Neko desktop into a web page without login prompt coming up for viewers:

http://<your-neko-server-ip>:8080/?usr=neko&pwd=neko

https://stackoverflow.com/questions/15276929/how-to-make-a-video-fullscreen-when-it-is-placed-inside-an-iframe

Your iframe needs an attribute: allowfullscreen="true" webkitallowfullscreen="true" mozallowfullscreen="true" or more modern allow="fullscreen *". For the second you can remove the star if your iframe has the same origin or replace it with your iframe origin.

Can I use neko without docker?

It is strongly recommended to use Neko with Docker, as it is the easiest way to run it. But you should be able to install Neko "natively" on your host system. Neko is based on Debian and uses Xorg and Pulseaudio. You would just need to follow steps that are in Dockerfile, install all dependencies on your host system and then just run it.

However, it is recommend to start with existing system that has GUI with desktop manager, is based on Xorg and uses Pulseaudio (e.g. Ubuntu Desktop 22.04). For that matter you only need to install gstreamer dependencies, configure pulseaudio properly and run neko binary (you don't need to build it from scratch, you can copy it from docker image).

2.5 KiB Raw Permalink Blame History