Skip to content

Add section BUGS to manual page describing headless operation in Linux #3062

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 30, 2015
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions build/shared/manpage.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -268,6 +268,26 @@ Install Bridge and Servo libraries

arduino --install-library "Bridge:1.0.0,Servo:1.2.0"

BUGS
----

Even in command line mode the Arduino IDE requires a graphical user interface to be
present. This should usually be the case in Windows or Mac OS X. On Linux however you
might want to compile and upload sketches when logged in via SSH or in batch mode. To
accomplish this, install the Xvfb dummy X server and write a small wrapper script to
create an instance of this Xserver, run the Arduino IDE in it and kill the Xserver
afterwards:

#!/bin/bash
Xvfb :1 -nolisten tcp -screen :1 1280x800x24 &
xvfb="$!"
DISPLAY=:1 arduino $@
kill -9 $xvfb

Save the script as *arduino-headless* and run it with the options described above.
If the script does not return to a shell prompt, the options you specified were wrong
and the Arduino IDE actually opened a window, stop its execution with Ctrl+C.

HISTORY
-------
1.5.2::
Expand Down