Coder Social home page Coder Social logo

justfxdev / portable-kanboard-and-webserver Goto Github PK

View Code? Open in Web Editor NEW
7.0 3.0 3.0 74.96 MB

A working portable Kanboard System with an Apache Webserver, mysql and php without the need to have admin rights on Windows

kanban kanban-application kanban-board kanboard portable webserver

portable-kanboard-and-webserver's Introduction

north_west Use the table of contents

version license

โญ If you use it, you should star it on GitHub! It's the least you can do for all the work put into it!

๐Ÿ‡ฉ๐Ÿ‡ช Deutsche Fassung dieses Textes - update ausstehend!

Portable Kanboard (Windows)

Welcome to the portable version of the Kanban Tool Kanboard.

assets/image-20230202221431513

Quick start

Download the latest version of KanboardPortable.zip from the release section and unpack the archive. The destination folder does not matter. Recommendation: no spaces in the overall directory name. Do not branch too deeply. Example:

c:\tools\kanboardportable

assets/image-20230202215503444

After the archive has been unpacked, it is sufficient to execute usbwebserver.exe. If this worked without problems, it should be displayed as follows:

assets/image-20230202220142473

We do not need MySQL, but the Apache server should have a green tick. After starting the server components, the local browser is also started automatically, which then displays the Kanboard login:

assets/image-20230202220341057

The login details are as follows:

  • Name: admin

  • Password: admin!

The example project myProjekto can then be selected to get started:

assets/image-20230202220558501

or alternatively this link can be used: http://localhost/?controller=BoardViewController&action=show&project_id=6

How to update your existing portable version

  1. Make sure usbwebserver.exe is not running
  2. Rename you existing folder KanboardPortable to KanboardPortable_bck
  3. Install everything as described above in quick start section to \KanboardPortable
  4. Copy all contents from KanboardPortable_bck\www\data to KanboardPortable\www\data that's your folder with the sqlite database and all your task attachments (pictures, documents...)
  5. If you made changes to the usbwebserver, php or apache settings: copy all contents from KanboardPortable_bck\settings to KanboardPortable\settings
  6. If you installed additional plugins which are not included in the latest version then you have to copy them also or you may just install them again
    • In case of copy: your previous plugins are in KanboardPortable_bck\www\plugins. Copy the folders you need from there to KanboardPortable\www\plugins
  7. done

What is included?

The package consists of the following parts:

USBWebserver V8.6

A freeware tool for starting, stopping and managing an Apache web server and a MySQL database server instance.

Written by Leon de Vries with design by Bart Boerendans

License: Freeware / Open Source Software

More information: https://www.usbwebserver.net/webserver/

Documentation: https://www.usbwebserver.net/downloads/manual.pdf

Apache V2.4.52

License: Apache License 2.0

More information: https://httpd.apache.org/

MySQL Server 5.6

License: GNU GPL Version 2

More information: https://www.mysql.com/

php 8.1.3 x86 VC C++ 2019

More information: https://www.php.net/

phpMyAdmin 11.02.2022

License: GNU GPL Version 2

More information: https://www.phpmyadmin.net/

Access data
Link http://localhost/phpmyadmin
User root
Password usbw

This portable Kanboard version uses the file-based SQLite3 database. MySQL is only included here because it is part of the USBWebserver package.

If an error message appears when you log in for the first time: Perform a reload in the browser and log in again. This is because some files have not yet been created.

Kanboard V1.2.27

License: MIT License

More information: https://kanboard.org/

Contributors: https://github.com/kanboard/kanboard/graphs/contributors

Access data
Link http://localhost/?controller=BoardViewController&action=show&project_id=6
User admin
Password admin!

Included Kanboard PlugIns

PlugIn Name Version Description
Kanboard Core 1.2.27 Kanboard it self. The core of this project mangement tool
Auto E-Mail Extend Actions 1.2.5 Additional actions to send tasks or notifications by mail
AutomaticActionUX 2.5.0 A more userfriendly UX to create and manage automatic actions in Kanboard
Boardcustomizer 1.1.0dev Allows various settings to be made for the display at user level, e.g. hiding icons on the task cards.
ColorManager 3.5.0 Basic PlugIn. Provides numerous colour options for tags, categories and cards.
Coverimage 1.2.14.1 Allows pictures to be displayed in tasks on the board
Customizer 1.14.1 Individualization of Kanboard. Login screen. Favicons and more. Branding.
CustomUserCSS 1.0.0 Allows you to use your own user-specific CSS. Optional. Included here.
DueDate 1.2.1 Quickly switch the display of tasks on the board according to the original creation, due date or last modification of the tasks / cards.
EnableAttachmentRenaming 1.1.3dev Basic. Allows attachments to be renamed.
GrabScroll 0.2.3 By clicking and holding in a free area on the board, the board can be moved left and right.
CommentActions 1.0.1 Basic. Allows a new assignment to a responsible person to be defined directly below the comment input field.
ICalConfig 0.3.0 Allows to have just the task due dates in the Kanboard ICal Feed. Includes the option to set reminder delta (if the internet calendar client supports that)
KanboardPermalink 1.1.0 Nice to have. In the task menu of the map there is a link that copies a permanent link to this task to the clipboard.
MarkDownPlus 1.1.3 Allows Markdown Features to be used in comments and descriptions. e.g. emojis, checkboxes and Unicode conversions.
metaMagik 1.5.4 Basic: Allows custom fields to be added locally to boards or globally to the instance. Incl. typing (date e.g. with date selection box)
PasteImageToMarkdown 1.0.3dev Requires MarkDownPlus (see above) and allows images to be added to input boxes.
PluginManager 1.8.0 Basic. Replace the Installed Plugins section with an very improved interface and a new Plugin Manager and revamped Plugins Directory.
SubtaskDueDate 1.1.3 Adds a due date to subtasks
SubtasksOnBoard 1.0.9 Shows subtasks on the task card. The state of the subtasks can be modified directly on the card
Taglist 1.1.0 Basic. Adds a button to the filter bar that allows filtering by tags. At the touch of a button.
Task2PDF 1.8.0 Creates a printer friendly PDF of a task
ThemeMaestro v0.9.0 Theme for Kanboard. Important: Kanboard currently supports only one theme per installation. If there are several themes in the plug-in directory, unexpected page effects may occur.

Disable internal theme in Customizer PlugIn when using PlugIn Themes.
OverrideTranslation 1.0.34dev A tool that allows you to overwrite all translations, even those used in the core, with your own.

dev in the version number means: installed github development master (for whatever good reason)

Advantages

  • Requires no administrator rights (unlike xampp)
  • Runs without installation, even from a USB stick
  • Completely pre-configured incl. some plug-ins that are considered basics
  • Demo board included
  • The web directory (www) can simply be moved 1:1 to a web server on the internet and operated (Attention: the server and the application should be secured accordingly). As a rule, however, this should work immediately. Depends on the web hoster.
  • The "www" directory can also be used on other operating systems if you have installed a local web server there. Simply copy 1:1
  • MySQL is not required. The package works with the file-based SQLite3. MySQL is included but not in use. Kanboard can also be set up to use MySQL (or Progress or MS-SQL).
  • For test purposes
  • Or as a personal, local system (or mobile on a USB stick)
  • The web backend can also be used for other systems. WordPress locally with MySQL? No problem...
  • phpMyAdmin as database administration interface is also included (not relevant for this Kanboard configuration as SQLite3 is used).
  • Together with Visual Studio Code, an optimal package for developers who contribute to the core or write and improve plug-ins.

Tips

  • If the configuration of php or Apache is to be changed: the corresponding files are located under C:\Tools\KanboardPortable\settings The files are copied from there to the actual locations of the other programmes when the USB web server is started. It therefore makes no sense to make changes in the php or apache or other directories.
  • The web server package is also suitable for all other systems that are based on Apache and MySQL (WordPress, DokuWiki, etc. pp.).
  • It runs without admin rights (unlike the xampp package)
  • The directory www contains everything that Kanboard needs to operate.
  • If you want to use other web-based $things you should create a directory under www and put everything there. e.g. wordpress Then you can access it via http://localhost/wordpress.
  • Please update the security tokens if Kanboard is not used locally and stand alone. Go to application settings and reset:
    • Webhooks
    • API

Contributors

  • Fx - Author

  • ThomasFis - Translations

  • The images contained in the Demoboard are subject to the following licence: CC-BY-SA 3.0 by Fx

  • Support for this project is most welcome

portable-kanboard-and-webserver's People

Contributors

justfxdev avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Forkers

dheia xet7 fallendev

portable-kanboard-and-webserver's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.